MCP Demo Server

🚀 MCP 示範服務器

這是一個簡單的 Model Context Protocol (MCP) 服務器示例項目，展示瞭如何使用 Python 構建基本的 MCP 工具，幫助開發者快速上手 MCP 相關開發。

✨ 主要特性

本項目實現了兩個簡單的 MCP 工具：

• add：一個簡單的加法函數，接受兩個整數並返回其總和。
• say_hello：一個問候函數，接受名字參數並返回問候語。

📦 安裝指南

克隆項目

git clone [repository-url]
cd mcp-demo

創建虛擬環境並安裝依賴

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate
pip install mcp[cli]

💻 使用示例

基礎用法

要啟動 MCP 服務器，請執行：

uv run --with mcp[cli] mcp run server.py

高級用法

在開發模式下測試 MCP 服務器：

mcp dev server.py

這個命令會：

1. 在開發模式下啟動服務器。
2. 自動重新載入代碼變更。
3. 提供更詳細的調試信息。

📚 詳細文檔

項目結構

mcp-demo/
├── server.py        # MCP 服務器主程序
├── .gitignore      # Git 忽略文件
└── README.md       # 本文件

開發說明

服務器實現了兩個基本工具：

1. add(a: int, b: int) -> int

   • 功能：將兩個整數相加。
   • 參數：
     • a：第一個整數。
     • b：第二個整數。
   • 返回：兩數之和。

2. say_hello(name: str) -> str

   • 功能：生成個性化的問候語。
   • 參數：
     • name：要問候的人名。
   • 返回：包含問候語的字符串。

配置

項目包含 VS Code 配置文件 (.vscode/mcp.json)，可直接在 VS Code 中執行和測試 MCP 服務器。

GitHub Copilot 配置

要在 GitHub Copilot 中使用此 MCP 服務器，請在 VS Code 中進行以下設置：

1. 在項目根目錄創建 .vscode 文件夾（如果還沒有的話）。

2. 在 .vscode 文件夾中創建 mcp.json 文件，內容如下：

{
    "servers": {
      "Demo": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "mcp[cli]",
          "mcp",
          "run",
          "${workspaceFolder}/server.py"
        ]
      }
    }
}

3. 設置完成後，GitHub Copilot 將能夠自動連接到您的 MCP 服務器，並使用其提供的工具功能。

⚠️ 重要提示

• 確保已正確安裝 uv 套件管理工具。
• ${workspaceFolder} 會自動被替換為您的項目根目錄路徑。
• 如果使用不同的 Python 環境管理工具，可以適當調整相應的配置。

🔧 技術細節

技術需求

• Python 3.x
• MCP (模型上下文協議) 庫
• uv (Python 套件管理工具)