Mcpservercsharp

🚀 使用 C# 和 Firebird 的 MCP 服務器

本項目是一個支持自定義工具的 Modular Command Platform (MCP) 服務器，採用 C# 編寫。其一大特色功能是能夠在 Firebird 數據庫中執行動態查詢，同時支持過濾和記錄限制。

🚀 快速開始

本項目是一個支持自定義工具的 Modular Command Platform (MCP) 服務器，由 C# 編寫而成。藉助它，你可以在 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 數據庫表中返回記錄，支持以下功能：

• 🔍 條件過濾（通過 SQL）
• 🔢 記錄數限制（使用 FIRST）

基礎用法

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

🔧 技術細節

📦 所用技術

• NPX
• C# (.NET 9 框架)
• MCP（Modular Command Platform）
• FirebirdSql.Data.FirebirdClient
• 依賴注入（通過 Host.CreateApplicationBuilder 實現）
• 配置文件（通過 appsettings.json 實現）

🏡 運行 MCP 服務器

使用以下命令運行 MCP 服務器：

npx @modelcontextprotocol/inspector dotnet run