🚀 CompText MCP服务器
用于MCP、REST和移动代理的令牌高效DSL服务器
   
CompText将冗长的指令编译成紧凑的DSL，将LLM令牌的使用量减少了90-95%。该存储库附带了一个生产就绪的MCP服务器、REST网关和一个移动自动化代理。
______________________________________________________________________
目录
- MCP 服务器 - REST API - 移动代理CLI
______________________________________________________________________
概述
CompText MCP服务器通过以下方式公开CompText DSL：
- 主控程序 用于本地工具访问（Claude Desktop、Cursor等）
- 表征状态转移 用于HTTP客户端（困惑，ChatGPT API类型的调用程序）
- 移动代理 使用最少的令牌实现Android自动化
所有服务共享相同的验证、缓存、指标和安全强化，如中所述 OPTIMIZATION_SUMMARY.md.
特性
- 具有缓存和输入验证的令牌高效DSL
- 双接口：MCP服务器和REST包装器
- 具有Ollama/Cloud模式和Prometheus指标的移动代理
- 速率限制、净化和结构化日志记录
- Docker支持加上铁路/渲染配置
- GitHub仓库自动化：审核、自动合并PR和管理默认分支
建筑
Client (MCP / REST / Mobile) -> CompText Server -> Data Source (Local JSON or Notion)
|-> Validation & rate limiting
|-> Metrics & logging
|-> Caching layer数据源
服务器支持两种数据源模式：
- 本地JSON （默认）：使用
data/codex.json用于快速离线访问 - API通知：使用Notion数据库进行基于云的内容管理
使用在模式之间切换 COMPTEXT_DATA_SOURCE 环境变量。
先决条件
- Python 3.10+
- （可选）如果使用Notion作为数据源，则使用Notion API令牌
- 推荐：virtualenv
快速开始
git clone https://github.com/ProfRandom92/comptext-mcp-server.git
cd comptext-mcp-server
python -m venv .venv
source .venv/bin/activate # Windows: .venv\\Scripts\\activate
pip install -e .[rest,mobile]
cp .env.example .env
# Option 1: Use local JSON (default, no additional config needed)
python -m comptext_mcp.server
# Option 2: Use Notion API (edit .env first)
# Set COMPTEXT_DATA_SOURCE=notion
# Fill in NOTION_API_TOKEN and COMPTEXT_DATABASE_ID
python -m comptext_mcp.server
# (Optional) Start REST API
python rest_api_wrapper.py配置
所有配置都使用环境变量（请参见 .env.示例):
数据源配置
COMPTEXT_DATA_SOURCE–数据来源：“本地”（默认）或“概念”COMPTEXT_CODEX_PATH–本地JSON文件的路径（默认：“data/codex.JSON”）
Notion API配置（仅当使用Notion时）
NOTION_API_TOKEN–通知API令牌COMPTEXT_DATABASE_ID–Notion数据库ID
其他配置
GITHUB_TOKEN–GitHub API令牌（用于自动化功能）HOST/PORT–REST服务器主机/端口LOG_LEVEL–日志记录级别
用法
MCP 服务器
添加到您的MCP客户端（以Claude Desktop为例）：
使用本地JSON（默认）：
{
"mcpServers": {
"comptext-codex": {
"command": "python3",
"args": ["-m", "comptext_mcp.server"],
"cwd": "/path/to/comptext-mcp-server",
"env": {
"PYTHONPATH": "/path/to/comptext-mcp-server/src",
"COMPTEXT_DATA_SOURCE": "local",
"COMPTEXT_CODEX_PATH": "data/codex.json"
}
}
}
}使用Notion API：
{
"mcpServers": {
"comptext-codex": {
"command": "python3",
"args": ["-m", "comptext_mcp.server"],
"cwd": "/path/to/comptext-mcp-server",
"env": {
"PYTHONPATH": "/path/to/comptext-mcp-server/src",
"COMPTEXT_DATA_SOURCE": "notion",
"NOTION_API_TOKEN": "your_token",
"COMPTEXT_DATABASE_ID": "0e038c9b52c5466694dbac288280dd93"
}
}
}
}REST API
python rest_api_wrapper.py
curl http://localhost:8000/health看 docs/API.md 用于端点、速率限制和示例。
移动代理CLI
comptext-mobile run "Open Chrome and search for weather" --steps 10
comptext-mobile status
comptext-mobile screenshot --output screen.png通过环境或配置文件进行配置；详情见 docs/mobile-agent.md.
测试与整理
pip install -e .[dev]
pytest
black . && flake8 && mypy文档
贡献
我们欢迎问题和公关。请参阅 贡献.md 并遵循 代码_OF_CONDUCT.md.
安全
通过以下方式报告漏洞 安全.md该项目使用输入验证、速率限制和CodeQL扫描（请参阅CI）。
许可证
MIT© ProfRandom92