Etracker MCP

etracker MCP服务器

一个MCP（模型上下文协议）服务器，向人工智能助手公开etracker分析API。合作伙伴通过HTTP/SSE进行连接，并使用自己的API密钥加上每个请求传递的etracker帐户令牌进行身份验证。

建筑

• 运输： 流式HTTP（HTTP+SSE上的MCP）
• 认证： 双头方案-- X-Api-Key （合作伙伴密钥）+ X-ET-Token （etracker帐户令牌）
• 速率限制： 三层桶——爆裂防护（8个要求/10秒），全局窗口（40个要求/5分钟），每个合作伙伴窗口（20个要求/5 min）
• 会议： 在内存中，每个MCP会话的作用域。运行多个副本时需要会话关联性（ClientIP）。

端点

工具

所有数据工具均接受 from/to （YYYY-MM-DD，最长90天），可选 attributes 和 figures （每个最多5个）， limit/offset，以及 sort_column/sort_order.

认证

etracker令牌是 不 存储在服务器中——合作伙伴通过以下方式按请求传递它 X-ET-Token。服务器仅存储合作伙伴API密钥到合作伙伴ID的映射。

生成合作伙伴密钥：

openssl rand -hex 32

PARTNER_API_KEYS 格式（JSON对象）：

{"": "
", "": "
"}

本地开发

cp .env.example .env
# Edit .env and set PARTNER_API_KEYS
npm install && npm run dev

码头工人

docker build -t etracker-mcp .
docker run -p 3000:3000 \
  -e PARTNER_API_KEYS='{"mykey":"partner-a"}' \
  etracker-mcp

Docker Compose

cp .env.example .env
# Edit .env: set PARTNER_API_KEYS and IMAGE
docker compose up -d

Kubernetes/Helm

不要使用 --set 为了 partnerApiKeys --Helm解释 {, }，以及 , 作为特殊的语法，它会破坏JSON。请改用值文件：

# my-values.yaml
partnerApiKeys: '{"":"
"}'
service:
  type: ClusterIP  # or NodePort / LoadBalancer

helm install etracker-mcp ./helm -f my-values.yaml

入口

# my-values.yaml
partnerApiKeys: '{"":"
"}'
ingress:
  enabled: true
  className: nginx
  host: etracker-mcp.example.com
  tls: true
  tlsSecretName: etracker-mcp-tls

所有Helm值

MCP客户端配置

{
  "mcpServers": {
    "etracker": {
      "url": "https://etracker-mcp.example.com/mcp",
      "headers": {
        "X-Api-Key": "",
        "X-ET-Token": ""
      }
    }
  }
}