🚀 MCP 服务器构建指南

本指南旨在帮助你构建 MCP 服务器以实现办公自动化，详细介绍了构建的计划、实施过程以及相关配置等内容。

🚀 快速开始

为了实现办公自动化，我们将按以下计划开展工作：

• 每天早上到岗后，查看日程安排。
• 检查当天的天气并通知。
• 查看邮件中的待回复邮件列表。
• 在协作工具 Jira 中列出尚未完成且分配给我的任务。

📦 安装指南

安装 uv

# 安装 uv
brew install uv

uv init [mcp-server-name] --python 3.12 # 指定版本  
cd [mcp-server-name]
uv venv # .venv 虚拟环境安装 
source .venv/bin/activate
uv add "mcp[cli]"

安装 toml 文件（包）及创建相关文件

# 安装 toml 文件（包）
cat pyproject.toml

# 创建 server.py 文件 
touch server.py

# 安装 cursor
brew install --cask cursor
cursor .

## 在 cursor 中执行命令
打开 cursor 应用 -> 按下 cmd + shift + p -> 执行 Shell Command：安装 'cursor' 命令

添加 cursor 文档

# 添加 cursor 文档
进入 Cursor 设置 -> 功能 -> 文档 > 点击“+添加新文档” ->
- MCP 官网 (https://modelcontextprotocol.io/)
- MCP llm.txt (https://modelcontextprotocol.io/llms-full.txt)
- MCP Python SDK (https://github.com/modelcontextprotocol/python-sdk)

配置 cursor 规则

# 配置 cursor 规则
参考 https://cursor.directory/fastapi-python-microservices-serverless-cursor-rules
-> 执行 npx 复制命令：npx cursor-directory rules add fastapi-python-microservices-serverless-cursor-rules
-> 在终端中执行配置

自行运行

# 自行运行
mcp dev server.py
mcp install server.py （运行后可检查 agent cursor, claude）

Docker（用于服务器订阅时使用）

# 构建镜像并启动容器（在后台运行）
$ docker compose up -d --build

# 查看日志（适用于后台运行）
$ docker compose logs -f

# 停止服务器
$ docker compose down

# 同时执行
$ docker compose down & docker compose up -d --build & docker compose logs -f

structlog 安装

uv pip install structlog

单元测试

uv pip install python-dotenv
uv pip install pytest requests

# 逐个运行测试
pytest test/test_github_tool.py
# 运行所有测试
pytest -v -s