Mcpservercsharp

🚀 C# と Firebird を使用した MCP サーバー

このプロジェクトは、カスタムツールをサポートする Modular Command Platform (MCP) サーバーで、C# で作成されています。主な機能の一つは、Firebird データベースで動的なクエリを実行し、フィルタリングとレコード制限を行うことができます。

🚀 クイックスタート

この MCP サーバーは、C# と Firebird を利用して、カスタムツールをサポートし、Firebird データベースでの動的クエリ実行を可能にします。以下のセクションでは、サーバーのセットアップと使用方法について説明します。

✨ 主な機能

• Firebird データベースでの動的クエリ実行
• 条件によるレコードのフィルタリング
• レコード数の制限

📦 インストール

依存関係のインストール

以下のコマンドを使用して、NuGet パッケージをインストールします。

dotnet add package ModelContextProtocol --prerelease

appsettings.json ファイルの設定

プロジェクトのルートディレクトリに appsettings.json ファイルを作成し、以下の内容を追加します。

{
    "ConnectionStrings": {
        "FirebirdDb": "Database=C:\\你的数据文件名.fdb;User=SYSDBA;Password=masterkey;Dialect=3;Charset=NONE;"
    }
}

📝 実際のデータベースファイルのパスに合わせて C:\\你的数据文件名.fdb を修正してください。

推奨されるプロジェクト構造

src/
├── MCPServer/
│ ├── Factory/
│ │ └── FbConnectionFactory.cs
│ ├── Tools/
│ │ └── FbQueries.cs
│ ├── Program.cs
│ └── appsettings.json

💻 使用例

基本的な使用法

ListTable ツールの使用

[McpTool, Description("列出 Firebird 表中的所有记录")]
public List<Dictionary<string, object>> ListTable(string tableName, string filter = "", int limitRecords = 0)

このツールを使用すると、Firebird データベースのテーブルからレコードを取得できます。以下は使用例です。

{
    "tool": "ListTable",
    "args": {
        "tableName": "CUSTOMERS",
        "filter": "STATUS = 'ACTIVE'",
        "limitRecords": 10
    }
}

この例では、CUSTOMERS テーブルから STATUS が ACTIVE のレコードを最大 10 件取得します。

📚 ドキュメント

所用技術

• NPX
• C# (.NET 9 フレームワーク)
• MCP（Modular Command Platform）
• FirebirdSql.Data.FirebirdClient
• 依存性注入（Host.CreateApplicationBuilder を使用）
• 設定ファイル（appsettings.json を使用）

🏡 MCP サーバーの実行

以下のコマンドを使用して、MCP サーバーを実行します。

npx @modelcontextprotocol/inspector dotnet run