MCP 伺服器展示

這個專案是一個練習用的 Model Context Protocol (MCP) server 實作，主要目的是為了學習和了解 MCP 的運作原理。

目的

本專案的主要目標：

• 學習 MCP 協議的基本概念
• 理解 MCP server 的運作機制
• 實作一個簡單的 MCP server 來加深理解

環境需求

環境需求：

• Ruby
• Node.js 和 npm（用於 MCP inspector）

與 Claude 整合

與 Claude 整合的步驟：

1. 複製或下載此專案到本地端。
2. 修改 Claude 的設定檔，加入以下 JSON 結構：

{
  "mcpServers": {
    "mcp_server_demo": {
      "command": "ruby",
      "args": [
        "<path_to_repository>/demo.rb"
      ]
    }
  }
}

注意：請將 <path_to_repository> 替換為您本地端專案的絕對路徑。

3. 重新啟動 Claude 以套用新設定。

測試方法

1. 使用 MCP Inspector

1. 安裝 MCP inspector：

npm install -g @modelcontextprotocol/inspector

2. 使用 inspector 運行伺服器：

npx @modelcontextprotocol/inspector ruby demo.rb

2. 直接 STDIO 測試

透過標準輸入發送 JSON-RPC 指令：

1. 初始化伺服器：

echo '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"sampling":{},"roots":{"listChanged":true}},"clientInfo":{"name":"mcp-inspector","version":"0.0.1"}}}' | ruby demo.rb

2. 列出可用工具：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | ruby demo.rb

3. 呼叫工具：

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"_meta":{"progressToken":0},"name":"calculate_sum","arguments":{"a":1,"b":2}}}' | ruby demo.rb

開發說明

主要元件：

• demo.rb：主要伺服器實作
• mcp_server.rb：核心 MCP 協議處理

授權條款

MIT 授權