使用说明
中心AI-MCP知识服务器
一个安全的模型上下文协议（MCP）服务器，具有优雅的管理web界面，用于人工智能知识管理。
特性
MCP服务器
- 真正的MCP协议：使用SSE传输的本地MCP实现
- 安全认证：所有MCP客户端的承载令牌身份验证
- 10个知识工具：AI助手的综合工具集
管理员Web UI
- 苹果风格设计：优雅的黑白界面，衬线字体
- 知识图谱：交互式D3.js可视化
- 全面管理：记忆、代码库、项目、指令
基础设施
- Docker Compose：完成容器化设置
- 隔离网络：仅暴露必要的端口
- 矢量搜索：Qdrant用于语义搜索
- PostgreSQL：结构化数据存储
快速开始
设置向导
chmod +x setup.sh
./setup.sh
交互式设置将指导您完成以下操作：
- 管理员凭据
- 安全令牌生成
- 数据库配置
- 端口分配
手动启动
# Copy environment template
cp .env.example .env
# Edit configuration
nano .env
# Start services
docker compose up -d
建筑
┌─────────────────────────────────────────────────────────────┐
│ EXTERNAL ACCESS │
│ (via Zoraxy/Nginx Reverse Proxy) │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ Admin UI │ │ MCP Server │ │
│ │ Port 2069 │ │ Port 2068 │ │
│ │ (localhost) │ │ (localhost) │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
├─────────────┴───────────────────────────┴───────────────────┤
│ INTERNAL NETWORK │
│ (centre-internal) │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ PostgreSQL │ │ Qdrant │ │ Redis │ │
│ │ (5432) │ │ (6333) │ │ (6379) │ │
│ │ internal │ │ internal │ │ internal │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
MCP工具
| 工具 | 说明 |
|---|---|
create_memory |
存储知识、事实、提醒 |
get_memory |
通过语义搜索检索记忆 |
get_codebase |
搜索索引代码库 |
capture_codebase |
索引本地代码库 |
get_instructions |
检索管理员配置的说明 |
who_am_i_talking_to |
获取管理员配置文件信息 |
project_overview |
查看托管项目 |
conversation_overview |
访问对话历史记录 |
web_search |
通过DuckDuckGo搜索网络 |
get_knowledge_graph |
检索知识图数据 |
MCP客户端配置
将此添加到您的MCP客户端（Claude Desktop、Cline等）：
{
"mcpServers": {
"centre-ai": {
"url": "http://localhost:2068/sse",
"transport": "sse",
"headers": {
"Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
}
}
}
}
在以下位置查找您的令牌：
.env文件(MCP_AUTH_TOKEN)- 管理UI设置页面
港口
| 服务 | 端口 | 访问 |
|---|---|---|
| MCP服务器 | 2068 | 仅限本地主机 |
| 管理UI | 2069 | 仅限本地主机 |
| PostgreSQL | 5432 | 仅限内部 |
| Qdrant | 6333 | 仅限内部 |
| Redis | 6379 | 仅限内部 |
反向代理设置
对于外部访问，请使用反向代理。看 ZORAXY.md 详细配置。
安全
- 认证：所有MCP请求都需要Bearer令牌
- 基于代用券：64个字符的十六进制标记
- 隔离网络：数据库服务未公开
- 非root Docker：容器以非root用户身份运行
- 会话管理：用于管理UI的安全会话Cookie
命令
# Start services
docker compose up -d
# View logs
docker compose logs -f
# Stop services
docker compose down
# Restart
docker compose restart
# Check status
docker compose ps
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
ADMIN_USERNAME |
管理员登录用户名 | admin |
ADMIN_PASSWORD |
管理员登录密码 | - |
SECRET_KEY |
会话加密密钥 | - |
MCP_AUTH_TOKEN |
MCP身份验证令牌 | - |
POSTGRES_DB |
数据库名称 | centre_ai |
POSTGRES_USER |
数据库用户 | centre_ai |
POSTGRES_PASSWORD |
数据库密码 | - |
MCP_PORT |
MCP服务器端口 | 2068 |
ADMIN_PORT |
管理UI端口 | 2069 |
LOG_LEVEL |
日志记录级别 | INFO |
文件结构
centre-ai/
├── mcp_server/ # MCP Server code
│ ├── __init__.py
│ ├── config.py # Configuration management
│ ├── database.py # Database connections
│ ├── server.py # MCP SSE server
│ └── tools.py # MCP tools implementation
├── admin_ui/ # Admin Web UI
│ ├── __init__.py
│ ├── app.py # FastAPI application
│ └── templates/ # Jinja2 templates
├── docker-compose.yml # Docker services
├── Dockerfile.mcp # MCP server container
├── Dockerfile.admin # Admin UI container
├── init-db.sql # Database schema
├── setup.sh # Setup wizard
├── requirements.txt # Python dependencies
├── ZORAXY.md # Reverse proxy guide
└── README.md # This file
许可证
麻省理工学院
贡献
欢迎投稿！请先阅读投稿指南。
