🔧 MCP Toolkit Server

Servidor de herramientas multifuncional basado en Model Context Protocol (MCP), que proporciona herramientas de operaciones de archivos, consultas de bases de datos, búsqueda web, cálculo, etc., y puede integrarse con clientes MCP como Claude Desktop, Cursor, Cline.

✨ Características

📁 Herramientas de operaciones con archivos

• list_directory - Lista el contenido del directorio

• read_file - Lee archivos de texto

• write_file - Escribe/añade contenido a archivos

• file_info - Obtiene metadatos del archivo

• search_files - Busca archivos mediante comodines

🗄️ Herramientas de bases de datos

• query_database - Ejecuta consultas SQL SELECT (solo lectura segura)

• list_tables - Lista todas las tablas

• describe_table - Muestra la estructura de la tabla

• init_sample_database - Inicializa una base de datos de ejemplo

🌐 Herramientas web

• web_search - Búsqueda web en DuckDuckGo (sin necesidad de API Key)

• fetch_webpage - Extrae el contenido principal de una página web

• webpage_info - Obtiene metadatos de la página web

🧮 Herramientas de cálculo

• calculate - Cálculo seguro de expresiones matemáticas

• convert_unit - Conversión de unidades (longitud/peso/temperatura/área/volumen)

• date_calculation - Cálculo de fechas (diferencia/suma y resta)

• percentage_calculation - Cálculo de porcentajes

Related MCP server: Claude Code Control MCP

🏗️ Diseño de arquitectura

┌─────────────────────────────────────────────────────┐
│              MCP 客户端 (Claude/Cursor)              │
└──────────────────────┬──────────────────────────────┘
                       │ MCP Protocol (stdio / HTTP)
┌──────────────────────▼──────────────────────────────┐
│              FastMCP Server 核心                      │
│  ┌──────────┐ ┌──────────┐ ┌────────┐ ┌──────────┐ │
│  │ 文件工具  │ │ 数据库工具│ │Web工具 │ │ 计算工具  │ │
│  └──────────┘ └──────────┘ └────────┘ └──────────┘ │
└─────────────────────────────────────────────────────┘

📦 Instalación

# 克隆仓库
git clone <repo-url>
cd mcp-toolkit-server

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env

🚀 Uso

1. Ejecución directa (modo stdio)

python server.py

2. Modo HTTP

python server.py --transport http --host 127.0.0.1 --port 8000

3. Integración con Claude Desktop

Edite el archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "toolkit": {
      "command": "python",
      "args": ["path/to/mcp-toolkit-server/server.py"],
      "env": {
        "ALLOWED_DIRS": "/path/to/your/workspace"
      }
    }
  }
}

4. Integración con Cursor

En la configuración de Cursor → MCP, añada:

{
  "mcpServers": {
    "toolkit": {
      "command": "python",
      "args": ["path/to/mcp-toolkit-server/server.py"]
    }
  }
}

📁 Estructura del proyecto

mcp-toolkit-server/
├── server.py                 # MCP 服务器主入口
├── config.py                 # 配置管理
├── requirements.txt          # 依赖
├── .env.example              # 环境变量模板
├── .gitignore
├── README.md
└── src/
    ├── __init__.py
    └── tools/
        ├── __init__.py
        ├── file_tools.py     # 文件操作工具
        ├── db_tools.py       # 数据库查询工具
        ├── web_tools.py      # Web 搜索/抓取工具
        └── calc_tools.py     # 计算/转换工具

🔒 Mecanismos de seguridad

1. Aislamiento de rutas: Las operaciones de archivos se limitan a los directorios configurados en ALLOWED_DIRS, evitando el path traversal

2. SQL de solo lectura: Las herramientas de base de datos solo permiten consultas SELECT, prohibiendo operaciones de escritura

3. Validación de identificadores: Los identificadores, como los nombres de tablas, se validan mediante expresiones regulares para evitar la inyección SQL

4. Sandbox de expresiones: El cálculo matemático utiliza un entorno eval restringido que prohíbe el acceso a funciones integradas

🎯 Aspectos destacados

1. Conforme a la especificación MCP: Basado en el framework oficial FastMCP, compatible con todos los clientes MCP

2. Amplia variedad de herramientas: 4 categorías principales y 17 herramientas que cubren escenarios comunes de desarrollo

3. Seguridad ante todo: Mecanismos de seguridad en múltiples capas para prevenir el uso indebido

4. Fácil de ampliar: Diseño modular; para añadir una nueva herramienta solo hay que escribir la función y registrarla

5. Doble modo de transporte: Admite dos modos de transporte: stdio (local) y HTTP (remoto)

🤝 Direcciones de expansión

• Añadir herramientas de operaciones de Git

• Añadir herramientas de ejecución de código (en sandbox)

• Añadir herramientas de envío de correo

• Añadir herramientas de gestión de calendario

• Añadir soporte para control granular de permisos de herramientas

• Añadir registros de auditoría de llamadas a herramientas

📄 Licencia

MIT