MCP Tool Suite

26 个 MCP Server，一套统一框架。 覆盖开发工具链、文档查询、浏览器自动化、设计协作、项目管理、错误监控、代码沙箱等场景，配套 Web 管理界面和可视化工作流设计器。

MCP 服务器一览

开发工具链

Server	说明	Tools	所需环境变量
📁 Filesystem	文件读写、目录操作、路径搜索	7	—
🔧 Git	版本控制全操作（commit/branch/diff/log）	9	—
🗄️ Database	MySQL / PostgreSQL / SQLite / Redis	7	—
🌐 HTTP Client	发送任意 HTTP 请求	5	—
📦 GitHub	仓库、Issue、PR、代码搜索	10	`GITHUB_TOKEN`
🖥️ Desktop Commander	终端命令执行、进程管理、文件编辑搜索	12	—

文档与知识

Server	说明	Tools	所需环境变量
📚 Context7	版本精确的库文档实时注入	2	`CONTEXT7_API_KEY`（可选）
📖 Docfork	9000+ 库文档语义搜索	2	`DOCFORK_API_KEY`
📄 DeepWiki	DeepWiki 文档 → 结构化 Markdown	1	—
🧠 Memory	持久化记忆、知识图谱	9	—

搜索与浏览器

Server	说明	Tools	所需环境变量
🔍 Brave Search	网页、新闻、图片、视频搜索	4	`BRAVE_API_KEY`
🌐 Browser	Playwright 浏览器自动化、截图、表单	9	—

团队协作与项目管理

Server	说明	Tools	所需环境变量
💬 Slack	消息推送、频道管理	8	`SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`
📝 Notion	页面、数据库、Block 管理	7	`NOTION_TOKEN`
📊 Google Sheets	表格创建、读写、格式化	6	`GOOGLE_CREDENTIALS_PATH`
📋 Linear	Issue CRUD、搜索、评论	5	`LINEAR_API_KEY`
🔗 Composio	500+ 应用统一集成（Slack/Jira/Gmail…）	6	`COMPOSIO_API_KEY`

设计与前端

Server	说明	Tools	所需环境变量
🎨 Figma	设计稿布局获取、图片资源下载	2	`FIGMA_API_KEY`
⚛️ ReactBits	135+ 动画 React 组件源码库	5	`GITHUB_TOKEN`（可选）

代码执行与监控

Server	说明	Tools	所需环境变量
📦 E2B	云端安全代码沙箱（Python/JS）	7	`E2B_API_KEY`
🐛 Sentry	错误监控、Issue 跟踪、事件分析	8	`SENTRY_ACCESS_TOKEN`

AI 推理

Server	说明	Tools	所需环境变量
🧩 Sequential Thinking	结构化推理、思维链分支与修订	1	—

生活与效率

Server	说明	Tools	所需环境变量
🗺️ 高德地图	路线规划、地理编码、实时路况	4	`AMAP_API_KEY`
💬 钉钉	Webhook 消息推送、群通知	3	`DINGTALK_WEBHOOK_URL`, `DINGTALK_SECRET`
🌤️ 天气	实时天气、多日预报	3	—
📅 日历	日程管理、提醒	3	—

合计：26 个 Server，139+ Tools

架构概览

                    ┌───────────────┐
                    │  Web UI /ui   │
                    │  Swagger /docs│
                    └───────┬───────┘
                            │
                    ┌───────▼───────┐
                    │   FastAPI     │
                    │   REST API    │
                    │  Auth + CORS  │
                    └───────┬───────┘
                            │
              ┌─────────────┼─────────────┐
              │             │             │
     ┌────────▼──────┐ ┌───▼───┐ ┌──────▼──────┐
     │ ServerFactory │ │Service│ │  Celery     │
     │ 26 Servers    │ │ Layer │ │  Workers    │
     └────────┬──────┘ └───────┘ └──────┬──────┘
              │                         │
     ┌────────▼──────┐          ┌──────▼──────┐
     │ BaseMCPServer │          │    Redis    │
     │ register_tools│          │  Broker +   │
     │ execute_tool  │          │  Result     │
     └───────────────┘          └─────────────┘

核心模式： 所有 Server 继承 BaseMCPServer，实现 register_tools → execute_tool 的统一接口。ServerFactory 管理 Server 配置和生命周期，MCPServerManager 负责进程监控和健康检查。

快速开始

1. 安装

git clone https://github.com/standup-coder/mcp4coder.git
cd mcp4coder

# 安装项目（含开发依赖）
pip install -e ".[dev]"

# 可选：安装特定 Server 的依赖
pip install -e ".[browser]"     # 浏览器自动化
pip install -e ".[google]"      # Google Sheets
pip install -e ".[notion]"      # Notion
pip install -e ".[database]"    # 数据库驱动
pip install -e ".[all]"         # 全部可选依赖

2. 配置环境变量

cp config/.env.example .env
# 编辑 .env 填入你的 API Key

必填项：AMAP_API_KEY、AMAP_ORIGIN、AMAP_DESTINATION、DINGTALK_WEBHOOK_URL、DINGTALK_SECRET、CELERY_BROKER_URL、CELERY_RESULT_BACKEND

生产环境必填：JWT_SECRET_KEY（未设置将拒绝启动）

3. 启动

# 启动 Redis（如果用 Docker）
docker compose -f deployment/docker-compose.yml up -d redis

# 启动应用
python -m app.main

# 另开终端：启动 Celery Worker
celery -A app.workers.celery_app worker --loglevel=info

4. 访问

地址	说明
http://localhost:8000	API 根路径
http://localhost:8000/docs	Swagger 交互式文档
http://localhost:8000/ui	Web 管理界面
http://localhost:8000/health	健康检查

环境配置

完整配置模板见 config/.env.example。按功能分组：

分组	关键变量	说明
安全	`JWT_SECRET_KEY`, `API_KEYS`	生产环境必须设置 JWT 密钥
高德地图	`AMAP_API_KEY`, `AMAP_ORIGIN`, `AMAP_DESTINATION`	通勤助手核心配置
钉钉	`DINGTALK_WEBHOOK_URL`, `DINGTALK_SECRET`	消息通知
Redis/Celery	`CELERY_BROKER_URL`, `CELERY_RESULT_BACKEND`	异步任务队列
GitHub	`GITHUB_TOKEN`	仓库/Issue/PR 操作
Slack	`SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`	频道消息
Brave Search	`BRAVE_API_KEY`	实时搜索
Notion	`NOTION_TOKEN`	页面/数据库管理
Google Sheets	`GOOGLE_CREDENTIALS_PATH`	表格操作
Context7	`CONTEXT7_API_KEY`	版本精确文档
Docfork	`DOCFORK_API_KEY`	文档语义搜索
Figma	`FIGMA_API_KEY`	设计稿数据
E2B	`E2B_API_KEY`	代码沙箱
Sentry	`SENTRY_ACCESS_TOKEN`	错误监控
Linear	`LINEAR_API_KEY`	项目管理
Composio	`COMPOSIO_API_KEY`	500+ 应用集成

API 使用

所有需要认证的端点支持 JWT Token 或 API Key（X-API-Key Header）。

获取 Token

# 开发环境 Demo Token
curl -X POST "http://localhost:8000/auth/token?username=demo&password=demo"
# → {"access_token": "eyJ...", "token_type": "bearer"}

列出所有 Server

curl http://localhost:8000/mcp/servers

执行工具

AUTH="Authorization: Bearer <your_token>"

# 读取文件
curl -X POST http://localhost:8000/mcp/execute/filesystem/read_file \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"path": "README.md"}'

# 查询 Context7 文档
curl -X POST http://localhost:8000/mcp/execute/context7/query_docs \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"libraryId": "/facebook/react", "query": "useEffect cleanup"}'

# 结构化推理
curl -X POST http://localhost:8000/mcp/execute/sequential_thinking/sequential_thinking \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"thought": "分析问题：用户登录失败的可能原因...", "thoughtNumber": 1, "totalThoughts": 3, "nextThoughtNeeded": true}'

# 执行终端命令
curl -X POST http://localhost:8000/mcp/execute/desktop_commander/execute_command \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"command": "git log --oneline -5", "timeout_ms": 10000}'

# E2B 代码沙箱
curl -X POST http://localhost:8000/mcp/execute/e2b/execute_code \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"code": "print(sum(range(100)))", "language": "python"}'

# Sentry 查看 Issue
curl -X POST http://localhost:8000/mcp/execute/sentry/get_issue \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"issue_id_or_url": "123456"}'

# GitHub 搜索代码
curl -X POST http://localhost:8000/mcp/execute/github/search_code \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"q": "function main language:python"}'

异步任务

# 触发通勤检查
curl -X POST http://localhost:8000/commute/check -H "$AUTH"
# → {"task_id": "abc-123", "status": "started"}

# 查询任务状态
curl http://localhost:8000/commute/status/abc-123

Docker 部署

开发环境

docker compose -f deployment/docker-compose.yml up -d

启动组件：Redis + App + Celery Worker + Celery Beat

生产环境

docker compose -f deployment/docker-compose.prod.yml up -d

单独构建镜像

docker build -f docker/Dockerfile -t mcp4coder:latest .
docker run -p 8000:8000 --env-file .env mcp4coder:latest

安全特性

特性	说明
JWT 认证	生产环境强制配置 `JWT_SECRET_KEY`，未设置则拒绝启动
API Key 认证	支持 `X-API-Key` Header 认证
Demo 端点隔离	`/auth/token` 仅开发环境可用，生产自动禁用
CORS 限制	白名单模式，生产环境从 `ALLOWED_ORIGINS` 加载
安全头	HSTS、CSP、XSS Protection、Frame Options
输入净化	请求参数自动净化，防止注入攻击
速率限制	内置 RateLimiter，默认 60 req/min
路径越界保护	Filesystem/Desktop Commander 限制在 `base_path` 内
Bandit 扫描	CI 中启用硬编码密码检测（B105/B106/B107）

项目结构

mcp4coder/
├── app/
│   ├── main.py                         # FastAPI 入口 + REST API 路由
│   ├── config/
│   │   ├── settings.py                 # Pydantic Settings 配置管理
│   │   └── validators.py              # 配置校验器
│   ├── mcp/
│   │   ├── servers/                    # 26 个 MCP Server 实现
│   │   │   ├── base_server.py          # BaseMCPServer 抽象基类
│   │   │   ├── amap_server.py          # 高德地图
│   │   │   ├── dingtalk_server.py      # 钉钉
│   │   │   ├── weather_server.py       # 天气
│   │   │   ├── calendar_server.py      # 日历
│   │   │   ├── filesystem_server.py    # 文件系统
│   │   │   ├── git_server.py           # Git
│   │   │   ├── database_server.py      # 数据库
│   │   │   ├── http_client_server.py   # HTTP 客户端
│   │   │   ├── github_server.py        # GitHub
│   │   │   ├── slack_server.py         # Slack
│   │   │   ├── brave_search_server.py  # Brave 搜索
│   │   │   ├── notion_server.py        # Notion
│   │   │   ├── google_sheets_server.py # Google 表格
│   │   │   ├── browser_server.py       # 浏览器自动化
│   │   │   ├── memory_server.py        # 记忆库
│   │   │   ├── context7_server.py      # Context7 文档注入
│   │   │   ├── sequential_thinking_server.py  # 结构化推理
│   │   │   ├── desktop_commander_server.py    # 终端命令
│   │   │   ├── docfork_server.py       # Docfork 文档搜索
│   │   │   ├── deepwiki_server.py      # DeepWiki 文档转换
│   │   │   ├── figma_server.py         # Figma 设计协作
│   │   │   ├── reactbits_server.py     # ReactBits 组件库
│   │   │   ├── e2b_server.py           # E2B 代码沙箱
│   │   │   ├── sentry_server.py        # Sentry 错误监控
│   │   │   ├── linear_server.py        # Linear 项目管理
│   │   │   └── composio_server.py      # Composio 多平台集成
│   │   ├── server_factory.py           # ServerType 枚举 + 工厂
│   │   └── server_manager.py           # 进程管理 + 健康检查
│   ├── middleware/
│   │   ├── auth.py                     # JWT + API Key 认证
│   │   └── security.py                 # 安全头 + 输入净化
│   ├── services/
│   │   └── commute_service.py          # 通勤助手业务逻辑
│   ├── workers/
│   │   ├── celery_app.py               # Celery 配置
│   │   └── tasks.py                    # 异步任务定义
│   ├── monitoring/
│   │   ├── performance_monitor.py      # 性能监控
│   │   └── system_monitor.py           # 系统监控
│   └── utils/
│       ├── logger.py                   # Loguru 日志
│       ├── error_handler.py            # 统一错误处理
│       └── helpers.py                  # 工具函数
├── web/
│   ├── mcp_manager.html                # Web 管理界面
│   └── workflow_designer.html          # 可视化工作流设计器
├── tests/
│   ├── conftest.py                     # 测试 fixtures
│   ├── test_config.py                  # 配置测试
│   ├── test_mcp.py                     # MCP Server 测试
│   ├── test_integration.py            # 集成测试
│   ├── test_e2e.py                     # 端到端测试
│   ├── test_security.py               # 安全测试
│   └── test_utils.py                   # 工具函数测试
├── docs/                               # 项目文档
│   ├── quick_start_guide.md
│   ├── detailed_operating_steps.md
│   ├── deployment.md
│   ├── SECURITY_CHECKLIST.md
│   └── ...
├── dumb_mode/                          # 极简独立模式（无需 FastAPI）
│   ├── commute_assistant.py
│   └── README_DUMB.md
├── docker/
│   └── Dockerfile
├── deployment/
│   ├── docker-compose.yml
│   └── docker-compose.prod.yml
├── scripts/
│   └── health_check.py
├── config/
│   ├── .env.example                    # 环境变量模板
│   ├── requirements.txt
│   └── pytest.ini
├── pyproject.toml                      # 项目元数据 + 工具配置
├── .bandit.yml                         # Bandit 安全扫描配置
├── .pre-commit-config.yaml             # Pre-commit hooks
├── CHANGELOG.md
├── CONTRIBUTING.md
└── CODE_OF_CONDUCT.md

开发新 Server

4 步创建一个新的 MCP Server：

1. 创建 Server 文件

# app/mcp/servers/my_server.py
from .base_server import BaseMCPServer, MCPTool, MCPResource, ServerCapability
from typing import Any, Dict, Optional

class MYMCPServer(BaseMCPServer):
    """命名规则：{VALUE}MCPServer，与 ServerType 枚举值对应"""

    def __init__(self, config: Optional[Dict[str, Any]] = None):
        # 在 super().__init__ 之前提取配置
        self.api_key = config.get("api_key", "") if config else ""
        super().__init__(config)

    def register_tools(self) -> None:
        self._register_tool(MCPTool(
            name="my_tool",
            description="工具描述",
            input_schema={
                "type": "object",
                "properties": {
                    "param1": {"type": "string", "description": "参数说明"}
                },
                "required": ["param1"]
            },
            capability=ServerCapability.READ  # READ | WRITE | EXECUTE
        ))

    def register_resources(self) -> None:
        self._register_resource(MCPResource(
            uri="my_server://status",
            name="状态",
            description="当前状态"
        ))

    async def execute_tool(self, tool_name: str, params: Dict[str, Any]) -> Any:
        if tool_name == "my_tool":
            return {"result": f"处理 {params['param1']}"}
        raise ValueError(f"未知工具: {tool_name}")

    async def _read_resource_content(self, resource: MCPResource) -> Any:
        if resource.uri == "my_server://status":
            return {"status": "ok"}
        raise ValueError(f"未知资源: {resource.uri}")

2. 注册到 ServerFactory

在 app/mcp/server_factory.py 中：

# ServerType 枚举
class ServerType(Enum):
    # ... 已有枚举
    MY = "my"  # 新增

# _load_builtin_servers()
ServerType.MY: ManagedServer(
    name="my-mcp-server",
    command="python",
    args=["-m", "app.mcp.servers.my_server"],
    env={"PYTHONPATH": "."},
    working_dir=".",
    timeout=300,
    max_concurrent=10,
    auto_restart=True,
    health_check_interval=120
),

3. 添加环境变量（如需）

在 config/.env.example 中添加占位符。

4. 验证

# 语法检查
python3 -c "import ast; ast.parse(open('app/mcp/servers/my_server.py').read())"

# 运行测试
pytest tests/ -v

Dumb 模式（极简版）

不需要 FastAPI / Celery / Redis，5 分钟上手的独立通勤助手：

cd dumb_mode
pip install -r requirements.txt
python commute_assistant.py

详见 dumb_mode/README_DUMB.md。

文档

文档	说明
快速开始指南	30 分钟上手教程
详细操作步骤	完整部署和配置
部署手册	生产环境部署
安全检查清单	安全配置审核
项目总结	项目完整总结
API 文档	REST API 说明
架构设计	系统架构
贡献指南	开发规范

贡献

欢迎贡献！请查阅 CONTRIBUTING.md 了解开发规范和提交流程。

# 安装 pre-commit hooks
pre-commit install

# 运行完整检查
black app/ && isort app/ && flake8 app/ && mypy app/ && pytest tests/

License

MIT License

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
.github/workflows		.github/workflows
.qoder		.qoder
app		app
config		config
deployment		deployment
docker		docker
docs		docs
dumb_mode		dumb_mode
examples		examples
scripts		scripts
tests		tests
web		web
.bandit		.bandit
.bandit.yml		.bandit.yml
.editorconfig		.editorconfig
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
mypy.ini		mypy.ini
pyproject.toml		pyproject.toml

Folders and files

Latest commit

History

Repository files navigation

MCP Tool Suite

目录

MCP 服务器一览

开发工具链

文档与知识

搜索与浏览器

团队协作与项目管理

设计与前端

代码执行与监控

AI 推理

生活与效率

架构概览

快速开始

1. 安装

2. 配置环境变量

3. 启动

4. 访问

环境配置

API 使用

获取 Token

列出所有 Server

执行工具

异步任务

Docker 部署

开发环境

生产环境

单独构建镜像

安全特性

项目结构

开发新 Server

1. 创建 Server 文件

2. 注册到 ServerFactory

3. 添加环境变量（如需）

4. 验证

Dumb 模式（极简版）

文档

贡献

License

About

Resources

License

Code of conduct

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages