Monkey

🚀 猴子 - 模型上下文協議（MCP）服務器

本項目是一個基於 .NET 9.0 實現的模型上下文協議（MCP）服務器。MCP 服務器所提供的通信協議，可用於基於模型的系統中各組件間的交互。此實現展示瞭如何藉助自定義工具和服務，搭建一個基礎的 MCP 服務器。

🚀 快速開始

嘗試運行

在 VS Code 中配置（使用 GitHub Copilot、Claude 桌面或其他 MCP 客戶端）：

{
    "inputs": [],
    "servers": {
        "monkeymcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "jamesmontemagno/monkeymcp"
            ],
            "env": {}
        }
    }
}

運行說明

在終端窗口中運行以下命令來啟動 MCP 服務器：

dotnet run --project ./MCP/Server.csproj

✨ 主要特性

核心組件

• MCP 服務器：採用 ModelContextProtocol 庫（版本 0.1.0-preview.2）構建。
• 標準輸入輸出傳輸：通過 stdio 與客戶端進行通信。
• 自定義工具集成：包含創建和註冊 MCP 工具的示例。

服務

• MonkeyService：一個示例服務，可從 API 端點獲取猴子數據。
  • 提供方法以檢索所有可用猴子或按名稱查找特定猴子的信息。
  • 具備緩存功能，可提高性能。

可用工具

服務器暴露了幾個可供客戶端調用的工具：

猴子工具

• GetMonkeys：返回 JSON 序列化後的所有猴子列表。
• GetMonkey：根據名稱獲取特定猴子的信息。

回顯工具

• Echo：一個簡單的工具，回顯提供的消息，並在前面加上“hello”前綴。

📦 安裝指南

暫未提及具體安裝步驟，可參考上述運行說明啟動服務器。

💻 使用示例

基礎用法

在 VS Code 中配置客戶端：

{
    "inputs": [],
    "servers": {
        "monkeymcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "jamesmontemagno/monkeymcp"
            ],
            "env": {}
        }
    }
}

高級用法

客戶端配置示例（C#）：

var configuration = new ConfigurationBuilder()
    .AddJsonFile("client.json")
    .Build();

var mcpClient = new McpClient(configuration);
await mcpClient.StartAsync();

📚 詳細文檔

配置選項

主機配置

服務器使用 Microsoft.Extensions.Hosting（版本 9.0.3）進行配置：

• 支持從多個來源（JSON、環境變量、命令行）加載配置。
• 提供依賴注入服務的功能。
• 具備日誌記錄能力。

日誌提供程序選項

有多種日誌提供程序可供選擇：

• 控制檯：輸出到標準輸出。
• 調試：用於調試目的的日誌。
• 文件：將日誌寫入文件中。
• 事件源：通過事件源進行日誌記錄。

項目結構

• MonkeyService.cs：實現獲取猴子數據的服務。
• MonkeyTools.cs：MCP 工具，用於訪問猴子數據。
• Program.cs：配置並啟動 MCP 服務器的入口點。

依賴項

• Microsoft.Extensions.Hosting（9.0.3）：提供主機基礎結構。
• ModelContextProtocol（0.1.0-preview.2）：MCP 服務器實現。
• System.Text.Json（9.0.3）：用於 JSON 的序列化和反序列化。

📄 許可證

此項目在 MIT License 下可用。