MCP Server 101

🚀 克萊德 MCP 協議實踐

本倉庫是 MIT 領先去中心化 AI 盛典練習環節的內容，涵蓋了在 Windows 系統下，5 分鐘內啟動並運行克萊德 MCP 協議的基本步驟。

🚀 快速開始

本項目主要包含天氣應用設置和 SQL - lite 數據庫示例（用於 Bakery 數據）兩部分內容，下面將分別介紹其操作步驟。

✨ 主要特性

• 提供在 Windows 系統下快速啟動克萊德 MCP 協議的方法。
• 包含天氣應用和 SQL - lite 數據庫示例，展示不同場景下 MCP 協議的使用。

📦 安裝指南

天氣應用設置

先決條件

⚠️ 重要提示

需確保已通過 pip 安裝 uv 工具。

操作步驟

cd weather
uv run weather.py

此命令會在本地機器上啟動一個服務器。該 Python 文件包含相關工具，可供 LLM 從政府 API 獲取警報和預報信息。

克萊德配置設置

需在克萊德桌面更改 claude_config.json 文件，步驟如下：

1. 導航到文件 -> 設置 -> 開發者 -> 編輯配置。
2. 編輯配置部分並提供 Python 文件的絕對路徑。

完成以上步驟後，第一個 MCP 服務器就能在 5 分鐘內啟動並運行。

示例配置文件

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "<abs_path_to_file>/mcp-server-weather"]
    }
  }
}

SQL - lite 數據庫示例用於 Bakery 數據

運行 SQL 數據庫作為 MCP 服務器的步驟

1. 克隆倉庫：

   git clone https://github.com/modelcontextprotocol/servers.git
   

2. 切換到 SQLite 目錄：

   cd servers
   cd src
   cd sqlite
   

3. 安裝 Docker（如果需要）：
   • 遵循此鏈接中的說明：https://docs.docker.com/engine/install/
   • 根據文檔驗證其運行情況。
4. 構建 Docker 鏡像：

   docker build -t mcp/sqlite .
   

5. 更新克萊德配置文件：

   {
     "mcpServers": {
       "sqlite": {
         "command": "docker",
         "args": [
           "run",
           "--rm",
           "-i",
           "-v",
           "mcp-test:/mcp",
           "mcp/sqlite",
           "--db-path",
           "/mcp/test.db"
         ]
       }
     }
   }
   

6. 重啟克萊德以應用更改。

Bakery 數據庫設置

1. 創建 bakery 數據庫表：
   • ingredients (id, name, unit, quantity, cost, supplier, min_order_quantity)
2. 填充數據：
   • 添加 10 種配料及其最小訂貨量（MOQs）。
3. 添加查詢以實現：
   • 庫存低位警報。

📄 許可證

此倉庫遵循 MIT 許可證。

📚 詳細文檔

更多詳細信息可參考 MIT 領先去中心化 AI 典的文檔。