pymcp

pymcp es un proyecto de Python basado en FastMCP que proporciona herramientas para interactuar con bases de datos MySQL. Este proyecto admite la comunicación entre servidores y clientes, y permite recuperar y analizar datos a través de diversas herramientas.

Estructura del proyecto

Related MCP server: MySQL Database Access

Instalar y ejecutar

1. Instalar dependencias

Requiere Python 3.13 o posterior. Para instalar las dependencias, ejecute el siguiente comando:

2. Ejecute el servidor

Para ejecutar el servidor, ejecute main.py :

El servidor se ejecuta en 0.0.0.0:8080 de forma predeterminada.

3. Ejecute el cliente

Para ejecutar el cliente, ejecute client.py :

Los clientes pueden comunicarse con el servidor para ejecutar consultas MySQL o consultar una lista de herramientas.

Preferencias

La configuración de MySQL se aplica de forma diferente según el entorno:

• Entorno local : src/env.py

• Entorno de desarrollo : src/env_dev.py

El entorno se puede configurar a través de APP_ENV . El valor predeterminado es local .

Herramientas proporcionadas

Las herramientas que proporciona el servidor son:

1. describe_tools
   Enumera las herramientas disponibles y explica cómo utilizarlas.

2. query_mysql(sql: str)
   Ejecuta una consulta SQL determinada y devuelve los resultados.
   Ejemplo: query_mysql("SELECT * FROM users LIMIT 10;")

Descripción del archivo principal

main.py

Este es el punto de entrada para ejecutar el servidor. Inicialice la instancia de MCP, registre las herramientas y luego ejecute el servidor.

client.py

Este es el código del cliente que interactúa con el servidor. Puede conectarse al servidor y llamar a la herramienta.

src/mysql_tool.py

Este es un archivo que define herramientas relacionadas con MySQL. Puede ejecutar consultas SQL a través de herramientas como query_mysql .

src/env.py y src/env_dev.py

Archivo de variables de entorno que contiene la configuración de conexión de MySQL. Carga la configuración adecuada según el entorno.