AI导哈

插件式AI代理工具桥接器

Felix Hub是一个为AI代理设计的插件式工具桥接平台，通过REST API、Web面板、MCP协议和Telegram机器人实现与多种应用的无缝集成。

  • by hsynalv
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hsynalv/mcp-hub

使用说明

Felix Hub

对于AI代理 基于插件的车辆桥梁通过单个集线器，通过 REST API、网页面板、模型上下文协议 （MCP） 和 Telegram 机器人与 Cursor、Claude Desktop、n8n 和您的自定义应用程序进行集成。

Repo 文件夹名称mcp-hubCLI名称（mcp-hub-stdio为了向后兼容而保护。产品名称： Felix Hub.

奈瓦尔？

层次 解释
API 基于 Express 的 HTTP 服务mcp-server/，港口 8787)
Web用户界面 React+Vite SPA——登陆、聊天、设置、管理、可观察性
插件 GitHub，Notion，n8n，DB，RAG，brain，shell，…自动发现
主控程序 /mcp HTTP ve mcp-hub-stdio ile光标/克劳德桌面
永久性 MSSQL — 用户、聊天历史记录、加密设置
电报 Webhook + 通知频道从消息到 hub 的 agent 循环
政策 Onay merkezi，费率限制，审计日志 
┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│ Web / Chat  │────▶│   Felix Hub API  │────▶│  Pluginler  │
│ Telegram    │     │  auth · policy   │     │ GitHub · …  │
└─────────────┘     └────────┬─────────┘     └─────────────┘
                             │
                    ┌────────┴────────┐
                    │ MSSQL settings  │
                    │ chat · users    │
                    └─────────────────┘

快速启动（开发）

项目根目录 pnpm 使用（mcp-server/pnpm-lock.yaml).

cd mcp-server
pnpm install
pnpm install --dir frontend
cp .env.example .env
# .env → bootstrap değerleri (ENV-SETUP.md)
npm run hub:live

命令做什么 |--------|----------| | npm run hub:live API watch + UI 自动 构建每日巨人) | | npm run dev:all |API观察+Vite开发服务器(:5173 代理）| | npm run ui:build |生产SPA建设→ src/public/app |

Adresler（开发人员）：

URL 说明
http://localhost:8787/ 公共着陆
http://localhost:8787/login 奥图鲁姆
http://localhost:8787/today主面板（登录后）
http://localhost:8787/chat 索伯特探员
http://localhost:8787/settings 设置与整合
http://localhost:8787/health 健康检查

配置

有两层；详情： ENV-SETUP.md.

1） Bootstrap-- mcp-server/.env （服务器打开前必须）

  • HUB_READ_KEY, HUB_WRITE_KEY, HUB_ADMIN_KEY
  • HUB_MSSQL_URL, HUB_SETTINGS_MASTER_KEY, HUB_PERSISTENCE_ENABLED
  • 第一个用户 ： HUB_SEED_* （一次）

2） 集成 — Settings UI 或 .env

  • OpenAI、GitHub、Notion、n8n、， 电报 (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, …)
  • 在MSSQL中加密存储；大多数 hot-reload
  • 设置 → 在集成中使用眼睛图标显示记录的值

除了生产：

NODE_ENV=production
CORS_ALLOWED_ORIGINS=https://senin-domainin.com

生产（Docker）

服务器 码头工人 使用；本地机器开发。

cd mcp-server
cp .env.example .env   # production değerleri
docker compose up -d --build
  • 回复： mcp-server/docs/DOCKER-DEPLOY.md
  • Coolify：基本目录 mcp-server，港口 8787，环境 仅运行时
  • 电报webhook： https://<domain>/notifications/telegram/webhook
  • 秘密旋转： node scripts/rotate-telegram-webhook.js

MCP & 外部客户端

# HTTP MCP (Bearer HUB_WRITE_KEY)
curl -H "Authorization: Bearer $HUB_WRITE_KEY" http://localhost:8787/tools

# stdio (Cursor / Claude Desktop)
npx mcp-hub-stdio

安装说明： mcp-server/docs/integrations/

repo结构

mcp-hub/
├── mcp-server/           # Ana uygulama (API + pluginler + SPA build çıktısı)
│   ├── frontend/         # React UI kaynakları
│   ├── src/plugins/      # Plugin modülleri
│   ├── src/core/         # Auth, chat, policy, persistence, …
│   ├── Dockerfile
│   └── docker-compose.yml
├── ENV-SETUP.md          # Ortam değişkenleri rehberi
└── README.md

测试

cd mcp-server
npm run test:run
npm run validate:tools

文档

主题 文件
ENV/引导 ENV-SETUP.md
Docker部署 mcp服务器/docs/DOCKER-DEPLOY.md
服务器API mcp服务器/README.md
Plugin开发。 mcp服务器/docs/plugin-development.md

许可证

麻省理工学院

相关 MCP