AI导哈

Genie MCP 服务器

Genie MCP Server 是一个基于 Docker 的 HTTP/SSE 服务器，用于与 ChatGPT (Developer Mode) 集成，无需 API 密钥即可使用。

  • by yansalim
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 yansalim/genie-mcp-openia

使用说明

精灵MCP服务器（Docker）——Porta 9998

此仓库包含 汽车天才 怎么 MCP 服务器 旋转于 码头工人，扩展端点 HTTP/SSE 为了与 ChatGPT（开发者模式） 使用您的签名 ChatGPT Plus/团队/企业 — sem API密钥 在你的应用中。

摘要

  • 基地： node:22-alpine （容器中的最新节点）
  • 执行者a genie mcp （STDIO） 根据 Genie 教程
  • 国民 /mcp （HTTP流）e /sse （SSE）通过 mcp代理 不适用 端口9998
  • docker-compose.yml com restart: always, 健康检查 e第二卷
  • 可选服务 Cloudflare隧道 快速 HTTPS

📂 结构

  • Dockerfile --相反， automagik-genie e mcp-proxy启动 Proxy 在 :9998 spawnando genie mcp.
  • docker-compose.yml -公共a 9998:9998添加 healthcheck 和 volume ./genie:/workspace.
  • .env （可选） –定义 MCP_PROXY_API_KEY 要求 X-API-Key 在路上。

观察：O ChatGPT（开发者模式）costuma exoir 超文本传输安全协议使用服务 cloudflared （包括）或您自己的反向代理（Nginx/Traefik）使用TLS。

🚀 快速开始

1） 先决条件

  • Docker+Docker组合没有服务
  • （可选） 域名/HTTPS 哦 Cloudflare隧道

（2）提升服务

# (Opcional) proteger o endpoint com uma API key
echo 'MCP_PROXY_API_KEY=troque-por-uma-chave-forte' > .env

# Build e subida
docker compose build --no-cache
docker compose up -d

# Verificar
docker ps --format 'table {{.Names}}\t{{.Ports}}\t{{.Status}}'

（3）本地测试

# Healthcheck
curl -i http://localhost:9998/ping

# SSE (deve retornar cabeçalhos de evento)
curl -i http://localhost:9998/sse

# (se definiu a chave)
curl -i -H 'X-API-Key: troque-por-uma-chave-forte' http://localhost:9998/ping

如果一切顺利，你会看到 HTTP/1.1 200 OK 不 /ping.

🔌 端点

方法 路径 描述
GET /ping Proxy 健康检查
POST /mcp 运河 HTTP流 MCP段落
GET /sse 服务器发送的事件 做MCP

通信 MCP_PROXY_API_KEY 定义没有 .env，渴望 X-API-Key: <sua-chave> 在要求中。

🧠 USO com聊天（开发者模式）

  1. 主动开发者模式 无ChatGPT（设置→ 应用程序和连接器→ 高级）。
  2. 确保您的服务器可通过 超文本传输安全协议:
    • 快速选项绕过 Cloudflare 隧道（服务） cloudflared 做作曲）。
    • 生产：使用Nginx/Traefik com TLS。
  3. 嗯 设置→ 连接器→ 创建注册一个连接器，指向：
    • URL连接符: https://SEU-DOMINIO-OU-TUNEL/mcp
    • （如果使用键） 添加标题 X-API-Key.
  4. 在 打开聊天 开发者模式选择连接器（例如： 吉尼（MCP））和部分：

    使用 Genie 的工具 .”

收费在ChatGPT中进行的编排使用 您 的 ChatGPT 计划 （加/团队/企业）。残疾人 论坛 在ChatGPT（无头/CI/后端）中，使用密钥和代币收费API。

🌐 云雀隧道（可选）

哦 docker-compose.yml 包括一个服务 cloudflared 创建一个指向 HTTPS 隧道 genie-mcp:9998.

docker compose up -d cloudflared
docker logs -f cloudflared   # anote a URL https://<hash>.trycloudflare.com

使用 https://<hash>.trycloudflare.com/mcp 在 ChatGPT 中创建连接器。

在生产中，首选自定义域 + TLS，而不是稳定的 URL。

⚙️ 环境变量

创建一个 .env （可选）：

变量 必需 示例/默认 描述
MCP_PROXY_API_KEY 不 troque-por-uma-chave-forte 定义，要求 X-API-Key 路线 （/ping, /mcp, /sse).
TZ 不 UTC 容器的时区。

不需要 OPENAI_API_KEY ChatGPT 使用 MCP。只使用钥匙，如果你想 服务器本身 在ChatGPT之外调用LLM。

💾 持续性 & 日志

  • O体积 ./genie:/workspace 守护 状态 (.genie/e 日志 从服务。
  • 将此目录视为 敏感特别是如果您的 MCP 工具处理本地文件/项目。

🔄 更新

docker compose build --no-cache
docker compose up -d

# Conferir versões dentro do container
docker exec -it genie-mcp node -v
docker exec -it genie-mcp npm ls -g automagik-genie mcp-proxy

🧪 诊断（故障排除）

  • 404/502没有连接器：确认a 统一资源定位符 （使用 /mcp隧道/代理指向 :9998.
  • 401未经授权: 缺少 X-API-Key 当 MCP_PROXY_API_KEY 它是明确的。
  • Sem HTTPS：o ChatGPT costuma 没有 访问纯HTTP → 使用TLS（Cloudflare隧道或代理）。
  • 没有列出工具在 ChatGPT 中重新启动连接器并检查 日志:
docker logs -f genie-mcp

🏗️ 建筑（高级）

ChatGPT (Developer Mode)  ⇄  HTTPS  ⇄  [mcp-proxy (/mcp, /sse):9998]  ⇄  (STDIO)  ⇄  automagik-genie mcp
  • mcp代理 转换 HTTP/SSE 转换STDIO 并管理 精灵
  • 吉尼（MCP） 遵循官方命令 genie mcp （节点18+）

📜 许可证

遵守基础项目许可证（Genie/Automagik，mcp-proxy）和法学硕士提供商的政策。
根据您的环境（域、TLS、身份验证）调整此仓库。

💬 支持

打开一个 问题 通用域名格式：

  • 日志(docker logs -f genie-mcp)
  • 来自 /ping e /sse
  • 打印配置 连接器 （没有秘密）
# Comandos úteis
docker compose ps
docker logs -f genie-mcp
docker compose restart genie-mcp

相关 MCP