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" "<您的域名值>"