🔧 MCP Toolkit Server

Ein multifunktionaler Toolserver basierend auf Model Context Protocol (MCP), der Dateioperationen, Datenbankabfragen, Websuche, Berechnungen und andere Werkzeuge bereitstellt und von MCP-Clients wie Claude Desktop, Cursor, Cline usw. angebunden werden kann.

✨ Funktionen

📁 Dateiwerkzeuge

• list_directory - Verzeichnisinhalt auflisten

• read_file - Textdatei lesen

• write_file - Datei schreiben/anhängen

• file_info - Datei-Metainformationen abrufen

• search_files - Dateien per Platzhalter durchsuchen

🗄️ Datenbankwerkzeuge

• query_database - SQL-SELECT-Abfrage ausführen (nur lesend, sicher)

• list_tables - Alle Tabellen auflisten

• describe_table - Tabellenstruktur anzeigen

• init_sample_database - Beispieldatenbank initialisieren

🌐 Web-Werkzeuge

• web_search - DuckDuckGo-Websuche (ohne API-Schlüssel)

• fetch_webpage - Webseiteninhalt abrufen

• webpage_info - Webseiten-Metainformationen abrufen

🧮 Berechnungswerkzeuge

• calculate - Sichere Berechnung mathematischer Ausdrücke

• convert_unit - Einheitenumrechnung (Länge/Gewicht/Temperatur/Fläche/Volumen)

• date_calculation - Datumsberechnung (Differenz/Addition/Subtraktion)

• percentage_calculation - Prozentberechnung

Related MCP server: Claude Code Control MCP

🏗️ Architektur

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

📦 Installation

# 克隆仓库
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

🚀 Verwendung

1. Direkt ausführen (stdio-Modus)

python server.py

2. HTTP-Modus

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

3. Anbindung an Claude Desktop

Bearbeiten Sie die Konfigurationsdatei von 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. Anbindung an Cursor

In den Cursor-Einstellungen → MCP hinzufügen:

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

📁 Projektstruktur

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     # 计算/转换工具

🔒 Sicherheitsmechanismen

1. Pfadisolierung: Dateioperationen sind auf die in ALLOWED_DIRS konfigurierten Verzeichnisse beschränkt, um Pfad-Traversierung zu verhindern.

2. SQL-schreibgeschützt: Datenbankwerkzeuge erlauben nur SELECT-Abfragen, Schreiboperationen sind verboten.

3. Bezeichnerprüfung: Bezeichner wie Tabellennamen werden per regulärem Ausdruck validiert, um SQL-Injection zu verhindern.

4. Ausdrucks-Sandbox: Mathematische Berechnungen verwenden eine eingeschränkte eval-Umgebung; der Zugriff auf eingebaute Funktionen ist untersagt.

🎯 Kernhighlights

1. MCP-konform: Basierend auf dem offiziellen FastMCP-Framework, kompatibel mit allen MCP-Clients.

2. Umfangreiche Werkzeuge: 4 Kategorien mit 17 Werkzeugen, die häufige Entwicklungsszenarien abdecken.

3. Sicherheit zuerst: Mehrschichtige Sicherheitsmechanismen verhindern Missbrauch.

4. Einfach erweiterbar: Modulares Design; neue Werkzeuge erfordern nur das Schreiben einer Funktion und deren Registrierung.

5. Dualer Übertragungsmodus: Unterstützt stdio (lokal) und HTTP (remote) als Übertragungsarten.

🤝 Erweiterungsmöglichkeiten

• Git-Operationswerkzeuge hinzufügen

• Code-Ausführungswerkzeug hinzufügen (in einer Sandbox)

• E-Mail-Versandwerkzeug hinzufügen

• Kalenderverwaltungswerkzeug hinzufügen

• Feingranulare Steuerung der Werkzeugberechtigungen unterstützen

• Audit-Log für Werkzeugaufrufe hinzufügen

📄 Lizenz

MIT