MCP Server Example

🚀 MCP 服務器示例

本項目展示了運用 .NET 實現的基礎 MCP（模型上下文協議）服務器。它提供了與 MCP 客戶端交互的端點，還集成了諸如 MCP 監視器等測試與調試工具。此外，該示例還演示瞭如何通過用戶秘密配置實現與外部服務（如 GitLab）的集成。

🚀 快速開始

運行項目

[!NOTE] 若要運行 GitLab 工具（SearchGroupsAsync），請按照此處的說明操作。

dotnet build
dotnet run

運行上述命令後，您將看到類似如下的輸出：

正在構建...
info: Microsoft.Hosting.Lifetime[14]
      現在監聽地址：http://localhost:5168
info: Microsoft.Hosting.Lifetime[0]
      應用程序已啟動。按 Ctrl+C 關閉。
info: Microsoft.Hosting.Lifetime[0]
      主機環境：開發

請複製 Http URL，因為在運行 MCP 監視器時會用到它。

調試與測試

若您未收到預期響應，或者想在 VSCode 環境之外對 MCP 服務器進行測試和交互，可使用 MCP 監視器。該工具提供了一個用戶友好的界面，便於測試和調試 MCP 服務器。點擊此處訪問 MCP 監視器源代碼。

安裝並啟動 MCP 監視器

在終端中輸入以下命令來安裝並啟動監視器：

npx @modelcontextprotocol/inspector dotnet run

啟動後，您將看到如下輸出：

正在啟動 MCP 監視器...
⚙️ 代理服務器正在監聽端口 6277
🔍 MCP 監視器已運行在 http://127.0.0.1:6274 🚀
New SSE 連接

配置並連接 MCP 監視器

使用之前複製的 HTTP URL，選擇“傳輸類型”下拉菜單，並將其設置為 SSE，然後將此內容粘貼到 URL 文本框中（請在末尾添加 /sse），接著按 連接 按鈕：

查看可用工具

按下 列出工具 按鈕（位於 UI 中央），即可查看可用工具，界面將顯示如下內容：

現在，您可以開始進行實驗啦！

🔧 用戶秘密

若項目缺少 <UserSecretsId>，請運行以下命令來設置用戶秘密：

dotnet user-secrets init

配置 GitLab PAT

dotnet user-secrets set "GitLab:Token" "<您的令牌值>"

配置 GitLab 域名

dotnet user-secrets set "GitLab:domain" "<您的域名值>"