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

pymcp/
├── client.py          # 클라이언트 코드
├── main.py            # 서버 실행 코드
├── src/
│   ├── env.py         # 로컬 환경 설정
│   ├── env_dev.py     # 개발 환경 설정
│   ├── mcp_instance.py # MCP 인스턴스 초기화
│   ├── mysql_tool.py  # MySQL 관련 도구 정의
├── pyproject.toml     # 프로젝트 메타데이터 및 의존성
├── requirements.txt   # 의존성 목록
└── README.md          # 프로젝트 설명

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:

pip install -r requirements.txt

2. Ejecute el servidor

Para ejecutar el servidor, ejecute main.py :

python 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 :

python 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 .

export APP_ENV=dev  # 개발 환경 설정

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.