Fist Maestro MCP Servers

🚀 MCP 服務器項目

MCP（Model Context Protocol）服務器項目旨在支持 Cursor IDE 的智能功能，提供多種服務以增強開發體驗。當前包含示例服務和天氣服務這兩個主要服務。

🚀 快速開始

克隆項目

git clone <repository-url>
cd mcp-servers

安裝依賴

npm install

構建項目

• 構建所有服務：

npm run build

• 單獨構建某個服務（例如天氣服務）：

npm run build:weather

配置 MCP

編輯 ~/.cursor/mcp.json 文件，添加如下內容：

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "/your/path/to/mcp-servers/build/weather/index.js"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

啟動服務

• 啟動天氣服務：

npm run start:weather

• 啟動示例服務：

npm run start:demo

✨ 主要特性

MCP 服務器項目當前提供了兩個主要服務，分別是示例服務和天氣服務，具體特性如下：

示例服務（Demo）

• 位置：src/demo/
• 功能：展示 MCP 服務的基本結構和開發方法。
• 特點：
  • 簡單的請求響應示例
  • 基礎錯誤處理
  • 完整的代碼註釋，適合學習

天氣服務（Weather）

• 位置：src/weather/
• 功能：提供全球天氣查詢服務。
• 特點：
  • 即時天氣信息查詢
  • 提供未來五天的天氣預報
  • 支持多個城市同時查詢
  • 詳細的天氣數據

📦 安裝指南

開發環境要求

• Node.js 版本 16.0 或更高
• npm 版本 8.0 或更高
• TypeScript 版本 4.5 或更高
• 最新版本的 Cursor IDE

📚 詳細文檔

項目結構

• src：包含所有服務的源代碼。
  • demo：示例服務，展示 MCP 服務的基本結構和開發方法。
  • weather：天氣服務，提供即時天氣查詢功能。
• build：用於存放構建生成的文件。
• node_modules：項目依賴管理目錄。

開發指南

創建新服務

1. 在 src 目錄下創建新的服務目錄（例如 new-service）。
2. 拷貝現有服務（如 demo 或 weather）的結構，並根據需求進行調整。
3. 實現必要的控制器和服務邏輯。
4. 在項目根目錄的 package.json 中添加相應的構建和啟動腳本。

調試方法

1. 使用 console.error() 輸出調試信息。
2. 查看 Cursor IDE 的 MCP 日誌窗口。
3. 利用 TypeScript 的源碼映射功能進行調試。

測試指南

• 運行所有測試：

npm test

• 單獨運行某個服務的測試（例如天氣服務）：

npm test weather

常見問題解答

服務無法啟動

• 檢查是否有端口被佔用。
• 確保環境變量已正確配置。

API 調用失敗

• 確認 API 密鑰是否有效。
• 檢查網絡連接狀態。

Cursor IDE 未識別服務

• 確保 MCP 配置文件 mcp.json 正確無誤。
• 重啟 Cursor IDE 並重新加載項目。

貢獻指南

1. Fork 該項目到你的 GitHub 賬戶。
2. 創建一個新的分支用於開發新功能或修復問題：

git checkout -b feature/new-service

3. 提交代碼並推送到遠程倉庫：

git push origin feature/new-service

4. 提交 Pull Request 到主分支。

聯繫方式

如需進一步幫助或反饋問題，請聯繫項目維護者：

• 郵件：contact@example.com
• GitHub：你的GitHub鏈接

感謝您對 MCP 服務器項目的關注與支持！