AI馈电MCP连接器
独立MCP连接器 ai-feed.
它为ChatGPT公开了只读MCP工具,并将所有检索代理给受保护的 ai-feed 后端。连接器不直接读取Telegram,也不需要访问数据库。
快速入门
- 打开AI Feed机器人: https://t.me/aiaggregators_bot
- 运行:
/mcp_token- 将返回的令牌放入
.env:
AI_FEED_API_BASE_URL=http://localhost:9000
AI_FEED_API_KEY=your-personal-token- 启动连接器:
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
uvicorn ai_feed_mcp.http_app:app --host 0.0.0.0 --port 8081- 在ChatGPT中使用此MCP URL:
http://localhost:8081/mcp对于公共ChatGPT使用,将其部署在HTTPS后面并连接:
https://your-domain.example/mcp它的作用
- 暴露MCP工具:
search,search_sources,fetch - 呼叫私人
ai-feed用于检索的API - 返回规范值
t.me/...链接、片段和元数据 - 作为一个单独的存储库工作,可以独立显示和部署
建筑
ChatGPT -> AI Feed MCP Connector -> AI Feed Private API -> AI Feed index连接器故意设计得很薄:
- 无法直接访问数据库
- 无写入操作
- 无Telegram用户机器人逻辑
- 无语料库导出端点
MCP端点
流式HTTP MCP端点为:
/mcp示例公共URL:
https://your-domain.example/mcp可用工具
search
在相关的Telegram源中搜索查询。
search_sources
别名为 search 当客户端只需要可链接的源卡时。
fetch
获取之前返回的源id的完整规范化文档。
需求
- Python 3.12+
- 一
ai-feed启用MCP专用API的后端 - 一
AI_FEED_API_KEY具有只读MCP作用域
环境变量
看 .env.示例.
必修的:
AI_FEED_API_BASE_URL=http://localhost:9000
AI_FEED_API_KEY=your-read-only-token获取 AI_FEED_API_KEY 来自AI Feed机器人:
/mcp_token机器人为当前用户发放个人MCP令牌。重新发布令牌将使前一个令牌无效。
可选:
AI_FEED_TIMEOUT_SECONDS=20
MCP_SERVER_NAME=ai-feed
MCP_SERVER_VERSION=0.1.0
MCP_SERVER_PORT=8081本地跑
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
uvicorn ai_feed_mcp.http_app:app --host 0.0.0.0 --port 8081那么MCP端点是:
http://localhost:8081/mcp使用Docker运行
docker build -t ai-feed-mcp .
docker run --rm -p 8081:8081 --env-file .env ai-feed-mcp那么MCP端点是:
http://localhost:8081/mcp从主项目运行
从主 ai-feed 存储库:
docker compose up -d --build bot ai-feed-mcp使用当前的合成映射:
ai-feed私有API:http://localhost:9000- MCP服务器:
http://localhost:8083/mcp
在ChatGPT中连接
- 部署公共HTTPS后面的连接器。
- 使用以结尾的公共MCP URL
/mcp. - 将其作为自定义MCP连接器添加到ChatGPT中。
- 仅对内部演示使用只读身份验证或无身份验证。
重要提示:
- 在浏览器中打开MCP URL不是一种有用的健康检查
- 正确的检查是端点是否响应MCP传输
/mcp
安全模型
此存储库可以是公共的,但后端访问必须保持受限。
推荐生产型号:
- 每
ai-feed用户获得个人集成令牌 - 令牌的作用域仅限于MCP读取操作
- 连接器从不获取数据库凭据
- 后端执行速率限制、撤销和每用户配额
当前代币发行流程:
- 用户打开AI Feed机器人
- 用户跑步
/mcp_token - bot返回个人MCP令牌
- 用户将该令牌放入
AI_FEED_API_KEY
看 docs/public-access-model.md.
API私人合同
看 docs/ai-feed-api-controll.md.
当前状态
此存储库已准备好:
- 本地开发
- 独立部署
- ChatGPT MCP集成
什么仍然属于主 ai-feed 系统:
- 用户帐户生命周期
- 代币发行
- 源分配
- 速率限制
- 每用户访问策略
