Mcpsharp

🚀 MCPSharp

MCPSharp 是一個 .NET 庫，用於構建符合 Model Context Protocol (MCP) 標準的服務器和客戶端。該庫能簡化與 AI 模型的交互，支持工具註冊、資源管理，還可與 Microsoft.Extensions.AI 和 Semantic Kernel 集成。

✨ 主要特性

• 與 Microsoft.Extensions.AI 集成：可將 MCP 服務器無縫連接到任何 IChatClient 實現。
• 對 Semantic Kernel 支持：通過簡單註解就能把 Semantic Kernel 方法註冊為 MCP 工具。
• 動態工具註冊：支持在運行時添加和管理工具，增強了系統的靈活性。
• 資源通知機制：提供資源變化的通知功能，提升了系統的即時響應能力。

📦 安裝指南

文檔未提供安裝步驟，此部分跳過。

💻 使用示例

基礎用法

工具註冊

using Microsoft.SemanticKernel;

public class MySkillClass
{
    [KernelFunction("MyFunction")]
    public string MyFunction(string input) => $"Processed: {input}";
}

// MCP 服務器註冊Semantic Kernel 類
MCPServer.Register<MySkillClass>();

客戶端調用

var client = new MCPClient("MyClient", "1.0", "http://localhost:5000");
var result = await client.CallToolAsync("MyFunction", new Dictionary<string, object> { {"input", "test"} });

高級用法

XML 文檔支持

/// <summary>
/// 提供數學運算功能
/// </summary>
public class Calculator
{
    /// <summary>
    /// 將兩個數字相加。
    /// </summary>
    /// <param name="a">要相加的第一個數字。</param>
    /// <param name="b">要相加的第二個數字。</param>
    /// <returns>兩個數字的和。</returns>
    [McpTool]
    public static int Add(
        [McpParameter(true)] int a,
        [McpParameter(true)] int b)
    {
        return a + b;
    }
}

📚 詳細文檔

使用場景

• 當你需要快速搭建一個與 AI 模型交互的系統時。
• 你的項目需要與 Microsoft.Extensions.AI 集成時。
• 你希望利用 Semantic Kernel 的強大功能來擴展 MCP 功能時。
• 你需要在運行時動態添加或管理工具和資源時。

API 參考

屬性

方法

• MCPServer.StartAsync(string serverName, string version)：啟動 MCP 服務器。
• MCPServer.Register()：註冊一個包含工具或資源的類。
• MCPServer.AddToolHandler(Tool tool, Delegate func)：動態添加工具處理程序。

遷移注意事項

⚠️ 重要提示

• [McpFunction] 已棄用，建議使用 [McpTool] 替代。
• 舊的 MCPServer.RegisterTool<T>() 方法已棄用，推薦使用新的 MCPServer.Register<T>()。

🔧 技術細節

文檔未提供技術實現細節，此部分跳過。

🤝 貢獻指南

我們歡迎任何貢獻！請隨意提交 Pull Request 或提出問題。

📄 許可證

MCPSharp 項目採用 MIT 許可證。