🔧 MCP Toolkit Server

A multi-purpose tool server based on the Model Context Protocol (MCP), providing file operations, database queries, web search, calculations, and other tools that can be integrated with MCP clients such as Claude Desktop, Cursor, Cline, and more.

✨ Features

📁 File Operation Tools

• list_directory - List directory contents

• read_file - Read text files

• write_file - Write/append files

• file_info - Get file metadata

• search_files - Search files by wildcard

🗄️ Database Tools

• query_database - Execute SQL SELECT queries (read-only safe)

• list_tables - List all tables

• describe_table - View table structure

• init_sample_database - Initialize a sample database

🌐 Web Tools

• web_search - DuckDuckGo web search (no API Key required)

• fetch_webpage - Fetch webpage main content

• webpage_info - Get webpage metadata

🧮 Calculation Tools

• calculate - Safe mathematical expression evaluation

• convert_unit - Unit conversion (length/weight/temperature/area/volume)

• date_calculation - Date calculations (difference/add/subtract)

• percentage_calculation - Percentage calculations

Related MCP server: Claude Code Control MCP

🏗️ Architecture Design

┌─────────────────────────────────────────────────────┐
│              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

🚀 Usage

1. Run directly (stdio mode)

python server.py

2. HTTP mode

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

3. Integrate with Claude Desktop

Edit the Claude Desktop configuration file (claude_desktop_config.json):

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

4. Integrate with Cursor

In Cursor Settings → MCP, add:

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

📁 Project Structure

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

🔒 Security Mechanisms

1. Path Isolation: File operations are restricted to directories configured in ALLOWED_DIRS, preventing path traversal

2. SQL Read-Only: Database tools only allow SELECT queries, write operations are forbidden

3. Identifier Validation: Identifiers such as table names are validated via regex to prevent SQL injection

4. Expression Sandbox: Math calculations use a restricted eval environment that blocks access to built-in functions

🎯 Key Highlights

1. MCP Specification Compliant: Built on the official FastMCP framework, compatible with all MCP clients

2. Rich Tools: 4 categories with 17 tools, covering common development scenarios

3. Security First: Multiple layers of security mechanisms to prevent misuse

4. Easy to Extend: Modular design; adding a new tool only requires writing a function and registering it

5. Dual Transport Modes: Supports both stdio (local) and HTTP (remote) transport

🤝 Extension Directions

• Add Git operation tools

• Add code execution tools (sandboxed)

• Add email sending tools

• Add calendar management tools

• Support fine-grained tool permission control

• Add tool call audit logging

📄 License

MIT