Knapcode.SampleMcpServer

MCP 服务 - Knapcode.SampleMcpServer

此 README 使用 C# MCP 服务模板项目创建，展示了如何轻松使用 C# 创建 MCP 服务，并将其打包为 NuGet 包。

完整指南请参阅 aka.ms/nuget/mcp/guide。

发布到 NuGet.org 前的检查清单

• 按照以下步骤在本地测试 MCP 服务。
• 更新 .csproj 文件中的包元数据，尤其是 <PackageId>。
• 更新 .mcp/server.json 以声明 MCP 服务的输入。
  • 更多详情请参阅配置输入。
• 使用 dotnet pack 打包项目。

bin/Release 目录中会包含包文件（.nupkg），你可以将其发布到 NuGet.org。

在 VS Code 中使用 MCP 服务

将 MCP 服务包发布到 NuGet.org 后，你可以使用以下 VS Code 用户配置来下载并安装该 MCP 服务包。有关在 VS Code 中使用 MCP 服务的更多信息，请参阅在 VS Code 中使用 MCP 服务（预览）。

{
  "mcp": {
    "servers": {
      "Knapcode.SampleMcpServer": {
        "type": "stdio",
        "command": "dnx",
        "args": [
          "[email protected]",
          "--yes",
          "--",
          "mcp",
          "start"
        ],
        "env": {
          "WEATHER_CHOICES": "sunny,humid,freezing"
        }
      }
    }
  }
}

现在，你可以在 Copilot Chat 中请求一个随机数，例如 Give me 3 random numbers。它应该会提示你使用 Knapcode.SampleMcpServer MCP 服务上的 get_random_number 工具，并显示结果。

在 VS Code 中本地开发

若要直接从源代码（本地）测试此 MCP 服务，而不使用已构建的 MCP 服务包，请在项目目录中创建 .vscode/mcp.json 文件（VS Code 工作区设置文件），并添加以下配置：

{
  "servers": {
    "Knapcode.SampleMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<RELATIVE PATH TO PROJECT DIRECTORY>",
        "--",
        "mcp",
        "start"
      ],
      "env": {
        "WEATHER_CHOICES": "sunny,humid,freezing"
      }
    }
  }
}

或者，你也可以配置 VS Code 用户设置以使用本地项目：

{
  "mcp": {
    "servers": {
      "Knapcode.SampleMcpServer": {
        "type": "stdio",
        "command": "dotnet",
        "args": [
          "run",
          "--project",
          "<FULL PATH TO PROJECT DIRECTORY>"
          "--",
          "mcp",
          "start"
        ]
      },
      "env": {
        "WEATHER_CHOICES": "sunny,humid,freezing"
      }
    }
  }
}