ColorsMCP - 模型上下文协议 (MCP) 服务器

概述

这是一个使用 .NET 9.0 构建的模型上下文协议 (MCP) 服务器实现。

此服务器可用于访问有关颜色的知识。

更多信息请参阅 https://markharrison.io/doc-mcp

提供了不同的项目以支持：

• 标准输入输出 (STDIO)
• 支持 HTTP 流传输的 Docker 镜像
• 带有 OAuth 认证/授权的 HTTP 流传输 Docker 镜像
• 服务端发送事件 (SSE) 的 Azure 函数应用

示例

我需要一组来自蓝色家族的四种颜色——加上黑色……
   请添加到 colors.html 中以便我可以检查

配置 STDIO

VSCode 配置

文件名：.vscode\mcp.json

{
    "servers": {
        "colorsserver": {
            "type": "stdio",
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "c:/dev/ColorsMCP/ColorsMCP/ColorsMCP.csproj"
            ]
        }
    }
}

配置 HTTP - Docker

构建 Docker 文件

cd <projectroot>
docker build -f colorsmcp-http/Dockerfile -t colorsmcp-http:latest .
docker images

运行 Docker 文件

docker run -p 3000:8080 -p 3001:8081 -d colorsmcp-http:latest

VSCode 配置

文件名：.vscode\mcp.json

{
    "servers": {
        "colorsserver": {
            "type": "http",
            "url": "http://localhost:3000"
        }
    }
}

配置 SSE - Azure 函数应用

Azure 函数

有一个项目用于构建 Azure 函数应用。

请注意，MCP 服务器的 URL 将是 http://xxxxx.azurewebsites.net/runtime/webhooks/mcp/sse。

此外，还需要一个密钥。该密钥位于函数应用 | 密钥面板中，并命名为 mcp_extension。

该密钥的头部称为 x-functions-key。

VSCode 配置

VS Code 配置如下：

{
    "servers": {
        "colorsserver": {
            "type": "sse",
            "url": "https://xxxxx.azurewebsites.net//runtime/webhooks/mcp/sse",
            "headers": {
                "x-functions-key": "key"
            }
        }
    }
}

测试

$env:DANGEROUSLY_OMIT_AUTH = 'true'
npx @modelcontextprotocol/inspector