🔧 MCP Toolkit

开箱即用的 MCP (Model Context Protocol) 工具集 — 为 AI Agent 提供搜索、文件、Shell 能力

Plug-and-play MCP tools for AI agents — Search, File Ops, Shell, and more.

🎯 为什么需要这个？

MCP 生态缺一套开箱即用、中文友好的工具集。mcp-toolkit 填补这个空白：

• 🚀 一行命令启动 MCP Server

• 🔍 内置 web_search、file_ops、shell_exec 等高频工具

• 🌏 中文搜索源优先（百度、知乎、B站等）

• ⚡ 轻量无依赖（核心仅需 Python 3.10+）

📦 安装

pip install mcp-toolkit

🚀 快速开始

1. Web Search Server

mcp-toolkit search

在 Claude Desktop / Cline / Continue 中配置：

{
  "mcpServers": {
    "web-search": {
      "command": "mcp-toolkit",
      "args": ["search"]
    }
  }
}

Agent 可调用：

• web_search(query) — 多引擎搜索

• web_extract(url) — 提取网页内容

2. File Operations Server

mcp-toolkit file --workspace ./my-project

提供工具：

• read_file(path) — 读取文件

• write_file(path, content) — 写入文件

• list_dir(path) — 列出目录

• search_files(pattern) — 搜索文件

3. Shell Command Server

mcp-toolkit shell

提供工具：

• run_command(cmd, timeout) — 执行命令

• get_env(key) — 读取环境变量

4. 一键启动全部

mcp-toolkit all

🛠 内置工具

🌏 搜索引擎支持

默认支持中文源优先：

from mcp_toolkit import SearchServer

server = SearchServer(engines=["baidu", "google"])
server.serve()

📁 项目结构

mcp-toolkit/
├── mcp_toolkit/
│   ├── __init__.py
│   ├── cli.py          # 命令行入口
│   ├── search.py       # Web Search MCP Server
│   ├── file_ops.py     # File Ops MCP Server
│   ├── shell.py        # Shell MCP Server
├── README.md
├── LICENSE
└── pyproject.toml

🤝 贡献

欢迎 PR！特别需要：

• 🌏 更多中文搜索源

• 🔌 新 MCP Server（数据库、API 等）

• 📚 更多 Agent 框架配置示例

⭐ Star History

有用的话给个 ⭐ ！