Build Custom MCP Servers

🚀 自定義MCP服務器構建指南

本項目展示瞭如何藉助 MCP mcp[cli] Python SDK 構建一個簡單的 MCP 服務器。該服務器提供了一系列實用工具，涵蓋筆記管理、天氣信息獲取以及新聞搜索等功能，為用戶帶來便利。

🚀 快速開始

本項目藉助 MCP mcp[cli] Python SDK 構建了一個簡單的 MCP 服務器，提供了筆記管理、天氣信息獲取、新聞搜索等實用工具，所有筆記存儲在本地，通過 .env 文件中的 API 密鑰調用外部服務。

✨ 主要特性

• 筆記管理：可進行添加、閱讀、檢索最新筆記以及生成筆記摘要等操作，所有筆記均存儲在本地 📝。
• 天氣信息：利用 WeatherAPI.com 服務獲取指定城市的當前天氣數據 ☀️。
• 新聞搜索：通過 Brave Search API 執行新聞搜索 📰。
• 配置靈活：通過 .env 文件配置 API 密鑰，實現密鑰管理 🔑。
• 構建便捷：使用 mcp[cli] 進行構建 ⚙️。

📦 安裝指南

按照以下步驟運行 FastMCP 代理：

1. 先決條件：
   • 已安裝 Python 3.12。
   • 推薦使用虛擬環境管理工具（如 venv、pipenv、poetry 或 uv）。
2. 克隆倉庫（如果尚未克隆）：

# 確保你處於正確的父目錄中
git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers # 或者使用當前目錄如果已經克隆
cd Build-Custom-MCP-Servers 

3. 設置虛擬環境及安裝依賴項：
   • 安裝依賴項（假設使用 uv，基於 uv.lock 文件，否則調整為 pip/poetry）：

uv sync
uv lock
source .venv/bin/activate  # 在 Windows 中使用 `.venv\Scripts\activate`

- 或者

pip install uv # 如果你沒有安裝 uv
uv pip install -r requirements.txt # 或者 uv sync 如果直接使用 pyproject.toml
# 如果不使用 uv，通常: pip install -r requirements.txt 或 poetry install 或 pip install .

4. 配置環境變量：
   • 複製示例環境文件：

cp .env.example .env

- 編輯新創建的 `.env` 文件並添加你的 API 密鑰：

WEATHER_API_KEY="YOUR_WEATHER_API_KEY"
BRAVE_API_KEY="YOUR_BRAVE_API_KEY"

5. 運行代理：
   • 執行主腳本：

mcp install main.py

- FastMCP 服務器應被添加到 Claude Desktop。

mcp dev main.py

- 調試 MCP 服務器

🤝 貢獻指南

歡迎貢獻！請隨意提交拉取請求或打開問題。