🛠️ MCP Server with C# + Firebird

🛠️ C# + Firebird の MCP サーバー

このプロジェクトは、カスタムツールに対応した、C# で作成された MCP（Model Context Protocol）サーバーです。機能の 1 つとして、Firebird データベースでフィルターとレコード数の上限を指定した動的クエリを実行できます。

---

📦 使用技術

• NPX
• C# (.NET 9)
• MCP（Model Context Protocol）
• FirebirdSql.Data.FirebirdClient
• Host.CreateApplicationBuilder による依存性注入
• appsettings.json による設定

---

⚙️ 設定

NuGet で依存関係をインストールします。

dotnet add package ModelContextProtocol --prerelease

🔧 appsettings.json ファイル

プロジェクトのルートに appsettings.json ファイルを作成し、次の内容を記述します。

{
"ConnectionStrings": {
"FirebirdDb": "Database=C:\\yourdata.fdb;User=SYSDBA;Password=masterkey;Dialect=3;Charset=NONE;" }
}

📝 データベースの場所に合わせて、.FDB ファイルのパスを変更してください。

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

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

🧩 利用可能な MCP ツール

🔍 ListTable

[McpTool, Description("List all records from a Firebird table")]
public List<Dictionary<string, object>> ListTable(string tableName, string filter = "", int limitRecords = 0)

このツールは、次の機能を使って Firebird データベースのテーブルからレコードを返します。

🔎 SQL による条件フィルター

🔢 レコード数の制限（FIRST を使用）

使用例：

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

MCP サーバーの実行

  npx @modelcontextprotocol/inspector dotnet run