AI导哈

模型上下文协议服务器

一个用于与Data Fair生态系统交互的模型上下文协议（MCP）服务器，支持独立Docker容器和Data Fair堆栈两种部署模式。

  • by data-fair
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 data-fair/mcp

使用说明

@数据公平/mcp

与数据公平生态系统交互的模型上下文协议（MCP）服务器。

使用方式

此MCP服务器可用于两种不同的模式：

独立模式（Docker）

将MCP服务器作为远程连接到Data Fair实例的独立Docker容器运行。此模式使用 标准 传输，适合与LLM客户端（如Claude Desktop、VS Code）集成。

  • PORTAL_URL 是 必需的 --将其设置为要查询的数据集市门户的基本URL。
  • DATA_FAIR_API_KEY -用于验证对Data Fair实例的请求的可选API密钥。
{
  "mcpServers": {
    "data-fair-datasets": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PORTAL_URL=https://opendata.koumoul.com", "ghcr.io/data-fair/mcp"]
    }
  }
}

数据公平堆栈模式（web服务）

将MCP服务器作为web服务与Data Fair部署在同一基础架构堆栈中。在此模式下，服务器通常在以下位置可用 /mcp-server 与Data Fair实例位于同一域上（Data Fair部署在 /data-fair，一个门户网站 /等等）。

示例端点： https://opendata.koumoul.com/mcp-server/datasets/mcp

  • 使用 超文本传输协议 运输(TRANSPORT=http).
  • PORTAL_URL 是 可选的 --它是从反向代理标头中自动推断出来的(X-Forwarded-Host, X-Forwarded-Proto, X-Forwarded-Port).
  • IGNORE_RATE_LIMITING --绕过数据公平速率限制约束的可选秘密。
  • 身份验证由数据公平堆栈的反向代理和会话管理处理。

⚙️ 环境变量

变量 描述 默认值 模式
PORTAL_URL 数据集市门户的基本URL。在独立模式下需要。 -- 独立
DATA_FAIR_API_KEY API密钥发送到数据博览会进行身份验证。 -- 独立
IGNORE_RATE_LIMITING 发送到数据集市以绕过速率限制的密钥。 -- 仅堆栈
TRANSPORT 运输方式： stdio （独立）或 http （堆栈）。 stdio 独立/堆栈
PORT HTTP服务器监听的端口 8080 仅堆栈
OBSERVER_ACTIVE 启用Prometheus指标。 true 仅堆栈
OBSERVER_PORT Prometheus度量观察器的端口。 9090 仅堆栈

🔨 发展

看看 贡献指南.

相关 MCP