MCP Autojob Server

🚀 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