AI MCP门户
这个项目提供了一个基于FastAPI的后端和基于浏览器的门户，用于管理模型上下文协议（MCP）会话。该门户包括预配置的Chrome DevTools MCP插槽，这些插槽由XPRA远程桌面支持，并且还可以连接到自定义的MCP服务器。
先决条件
- Python 3.10及以上版本
- 一个作为OpenAI兼容API密钥导出的
OPENAI_API_KEY - 可选：通过设置覆盖默认的Chrome MCP或XPRA主机
CHROME_MCP_HOST/CHROME_XPRA_HOST
安装
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt复制 .env.example 到 .env （或创建 .env并在服务器启动前填入必要的值，或者在你的shell中导出这些值。
cp .env.example .env # optional helper if you maintain an example file至少，预期会包含以下变量：
OPENAI_API_KEY=sk-...
OPENAI_MODEL=gpt-4o-mini # optional, defaults to provider defaults when unset
OPENAI_BASE_URL=https://api.openai.com/v1 # optional
CHROME_MCP_HOST=10.160.13.110 # optional, defaults to 10.160.13.110
CHROME_XPRA_HOST=10.160.13.110 # optional, defaults to CHROME_MCP_HOST运行门户
使用 Uvicorn 启动 FastAPI 应用程序：
uvicorn index:app --reload --host 0.0.0.0 --port 8000然后打开 http://localhost:8000 翻译为中文是：“本地主机上的8000端口”。不过，通常我们不会直接翻译网址，而是理解为“访问本地计算机上的8000端口服务”。在中文语境中，我们可能会说“打开本地8000端口”或者“访问本地主机8000端口”来表达这个意思 在您的浏览器中。该门户列出了可用的MCP（可能是指某种集合或资源包）集合，允许创建会话、提交提示，并嵌入了XPRA远程桌面以供活跃会话使用。
API终端点
同一台服务器提供了一个门户所使用的JSON API。有用的端点包括：
GET /health– 基本健康检查GET /collections– 列出已注册的MCP集合和插槽POST /sessions– 从集合或自定义MCP URL创建新会话POST /sessions/{session_id}/tasks– 对活动会话执行任务
参考 index.py 以获取完整的路由列表和有效载荷格式。
开发小贴士
- 静态资源存放在
static/以及模板在templates/。 - 修改
ai_mcp_portal/session_manager.py自定义会话分配或集成替代的持久化层。 - 跑
python -m compileall .在提交更改之前，请运行您首选的测试套件。