MCP Server Demo Kat

🚀 MCP 服務器演示指南

本指南將詳細介紹如何創建一個簡單的模型上下文協議 (MCP) 服務器，並使用 MCP 檢查器和 Claude Desktop 進行測試，幫助你快速上手 MCP 服務器的搭建與使用。

🚀 快速開始

先決條件

• uv - 一個極快的 Python 包和項目管理器，用 Rust 編寫。

✨ 主要特性

本指南基於 modelcontextprotocol/python-sdk 的 README，增加了清晰性的說明，能讓你更輕鬆地創建和測試 MCP 服務器。

📦 安裝指南

1. 環境設置

uv init mcp-server-demo
cd mcp-server-demo

# 指定 Python 版本
echo "3.12" > .python-version

# 安裝 Python 之前創建新的虛擬環境
uv venv 

# 激活虛擬環境
source .venv/bin/activate.fish

# 驗證 Python 環境（檢查是否使用正確的 Python 環境）
which python
path/to/mcp-server-demo/.venv/bin/python

# 安裝 MCP 依賴項（添加到 pyproject.toml）
uv add "mcp[cli]"

# 驗證 MCP 依賴項是否正確安裝
uv tree

Resolved 28 packages in 3ms
mcp-server-demo v0.1.0
└── mcp[cli] v1.6.0
    ├── ...

💻 使用示例

基礎用法

2. 創建一個簡單的 MCP 服務器

# server.py
from mcp.server.fastmcp import FastMCP

# 創建一個 MCP 服務器
mcp = FastMCP("Demo")

# 添加一個加法工具
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# 添加一個動態問候資源
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

3. 使用 MCP 檢查器進行測試

啟動 MCP 檢查器

uv run mcp dev server.py

啟動 MCP 檢查器...
⚙️ 代理服務器在端口 6277 上監聽

測試 add 工具

1. 打開 MCP 檢查器
2. 點擊 "Connect"
3. 點擊 "Tools" 標籤
4. 在 "Tools" 標籤內點擊 "List Tools"

測試 get_greeting 資源

1. 打開 MCP 檢查器
2. 點擊 "Connect"
3. 點擊 "Resources" 標籤
4. 點擊 "List Templates"
5. 找到 "get_greeting"
6. 輸入一個名字（例如，"John"）
7. 點擊 "Read Resources"

示例響應：

{
  "contents": [
    {
      "uri": "greeting://John",
      "mimeType": "text/plain",
      "text": "Hello, John!"
    }
  ]
}

4. 使用 Claude Desktop 進行測試

在 Claude Desktop 中安裝 MCP 服務器

uv run mcp install server.py

[/dd/MM/YY HH:MM:SS] INFO     Added server 'Demo' to Claude config            claude.py:129
                     INFO     Successfully installed Demo in Claude app          cli.py:467

驗證配置

# 對於 macOS/Linux
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

示例配置：

{
  "servers": [
    {
      "name": "Demo",
      "url": "http://localhost:5000"
    }
  ]
}

使用 MCP 服務器

1. 啟動你的 MCP 服務器（例如，運行 python server.py）
2. 打開 Claude Desktop
3. 在 Claude 中輸入問題，例如：
   • "What is 5 plus 3?"
   • "今天是幾月？"

Claude Desktop 將使用 MCP 服務器提供的工具來回答這些問題。

📚 詳細文檔

常見問題

如何將自定義工具添加到 MCP 服務器？

• 在 server.py 中定義新工具，使用 @mcp.tool() 裝飾器
• 示例：

@mcp.tool()
def greet(name: str) -> str:
    """Greet someone"""
    return f"Hello, {name}!"

如何在多個 MCP 服務器之間選擇？

• 在配置文件中指定優先級順序
• 示例：

{
  "servers": [
    {
      "name": "Primary",
      "url": "http://primary-server:5000"
    },
    {
      "name": "Secondary",
      "url": "http://secondary-server:5000"
    }
  ]
}

📖 參考資料

• 模型上下文協議 > 使用 LLMs 構建 MCP
• 模型上下文協議 > 調試
• 模型上下文協議 > 檢查器