Mcpsharp

🚀 MCPSharp

MCPSharpは、Model Context Protocol (MCP) 標準に準拠したサーバーとクライアントを構築するための.NETライブラリです。このライブラリは、AIモデルとのやり取りを簡素化し、ツールの登録、リソース管理、およびMicrosoft.Extensions.AIとSemantic Kernelとの統合をサポートします。

✨ 主な機能

• Microsoft.Extensions.AIとの統合：MCPサーバーを任意のIChatClient実装にシームレスに接続できます。
• Semantic Kernelのサポート：簡単なアノテーションでSemantic KernelのメソッドをMCPツールとして登録できます。
• 動的ツール登録：実行時にツールの追加と管理をサポートし、柔軟性を高めます。
• リソース通知機構：リソースの変更を通知する機能を提供し、システムのリアルタイム応答能力を向上させます。

🚀 クイックスタート

使用シナリオ

• AIモデルとのやり取りを行うシステムを迅速に構築する必要がある場合。
• プロジェクトでMicrosoft.Extensions.AIとの統合が必要な場合。
• 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"} });

📚 ドキュメント

APIリファレンス

属性

• [McpTool]：クラスまたはメソッドをMCPツールとしてマークします。

  • オプションパラメータ：
    • Name：ツール名（デフォルト：クラス/メソッド名）。
    • Description：ツールの説明。

• [McpParameter]：関数パラメータのメタデータを提供します。

  • オプションパラメータ：
    • Description：パラメータの説明。
    • Required：必須パラメータかどうか（デフォルト：false）。

メソッド

• MCPServer.StartAsync(string serverName, string version)：MCPサーバーを起動します。
• MCPServer.Register()：ツールまたはリソースを含むクラスを登録します。
• MCPServer.AddToolHandler(Tool tool, Delegate func)：動的にツールハンドラーを追加します。

XMLドキュメントのサポート

MCPSharpは、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;
    }
}

移行に関する注意事項

• [McpFunction] は非推奨となっており、[McpTool] の使用をお勧めします。
• 旧版の MCPServer.RegisterTool<T>() メソッドは非推奨となっており、新しい MCPServer.Register<T>() の使用を推奨します。

コントリビューションガイド

私たちは、どんな形の貢献も歓迎します！自由にPull Requestを送信するか、質問を提出してください。

📄 ライセンス

MCPSharpプロジェクトは、MITライセンスの下で提供されています。