An AI-driven platform for frontend semantic cognition and automation.
基于模型上下文协议(MCP)的强大工具集合,提供浏览器自动化、AI分析、视觉处理、网页爬虫、自动化测试生成和DevTools分析等功能。
本项目专为本地单用户使用设计,不适合公开部署。
# 克隆项目
git clone <repository-url>
cd percepta-mcp
# 安装依赖 (推荐使用 uv)
uv venv
uv sync
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件,添加您的 API 密钥
# 安装浏览器驱动
uv run playwright install chromium
# 启动服务
uv run python -m src.percepta_mcp.server
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件
# 构建并启动
docker-compose up -d
# 查看状态
docker-compose ps
curl http://localhost:8000/health
编辑配置文件 claude_desktop_config.json
:
本地运行配置:
{
"mcpServers": {
"percepta-mcp": {
"command": "uv",
"args": ["run", "python", "-m", "src.percepta_mcp.server"],
"cwd": "/path/to/percepta-mcp"
}
}
}
Docker 配置:
{
"mcpServers": {
"percepta-mcp": {
"command": "docker",
"args": ["exec", "percepta-mcp", "uv", "run", "python", "-m", "src.percepta_mcp.server"]
}
}
}
配置 settings.json
:
{
"mcp.servers": {
"percepta-mcp": {
"command": "uv",
"args": ["run", "python", "-m", "src.percepta_mcp.server"],
"cwd": "${workspaceFolder}"
}
}
}
percepta-mcp/
├── src/percepta_mcp/
│ ├── server.py # MCP 服务器主入口
│ ├── config.py # 配置管理
│ ├── ai_router.py # AI 提供商路由
│ └── tools/ # 工具模块
├── tests/ # 测试文件
├── .env.example # 环境变量模板
├── docker-compose.yml # Docker 部署配置
└── Dockerfile # Docker 镜像构建
# 运行所有测试
uv run pytest
# 带覆盖率报告
uv run pytest --cov=src --cov-report=html
当前测试覆盖率: 89% (209个测试全部通过)
关键环境变量配置:
OPENAI_API_KEY
: OpenAI API 密钥ANTHROPIC_API_KEY
: Anthropic API 密钥GOOGLE_API_KEY
: Google AI API 密钥PERCEPTA_HOST
: 服务监听地址 (默认: 0.0.0.0)PERCEPTA_PORT
: 服务端口 (默认: 8000)PERCEPTA_LOG_LEVEL
: 日志级别 (默认: INFO)MIT License
The definitive Vibe Coder's sanity check MCP server: Prevents cascading errors by calling a "Vibe-check" agent to ensure alignment and prevent scope creep
Interacting with Phabricator API
Create crafted UI components inspired by the best 21st.dev design engineers.
Model Kontext Protocol Server for Kubernetes that allows LLM-powered applications to interact with Kubernetes clusters through native Go implementation with direct API integration and comprehensive resource management.
Official MCP server for Sentry.
Official MCP server for Buildable AI-powered development platform. Enables AI assistants to manage tasks, track progress, get project context, and collaborate with humans on software projects.
Execute shell commands without permission prompts.
MCP Server that exposes Creatify AI API capabilities for AI video generation, including avatar videos, URL-to-video conversion, text-to-speech, and AI-powered editing tools.
A comprehensive proxy that combines multiple MCP servers into a single MCP. It provides discovery and management of tools, prompts, resources, and templates across servers, plus a playground for debugging when building MCP servers.
🍎 Build iOS Xcode workspace/project and feed back errors to llm.