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.

______________________________________________________________________

🔌 端点

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

______________________________________________________________________

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

1. 主动开发者模式 无ChatGPT（设置→ 应用程序和连接器→ 高级）。
2. 确保您的服务器可通过 超文本传输安全协议:

- 快速选项绕过 Cloudflare 隧道（服务） cloudflared 做作曲）。 - 生产：使用Nginx/Traefik com TLS。

1. 嗯 设置→ 连接器→ 创建注册一个连接器，指向：

- URL连接符: https://SEU-DOMINIO-OU-TUNEL/mcp - （如果使用键） 添加标题 X-API-Key.

1. 在 打开聊天 开发者模式选择连接器（例如： *吉尼（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://.trycloudflare.com

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

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

______________________________________________________________________

⚙️ 环境变量

创建一个 .env （可选）：

不需要 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