Skip to main content
Glama
0x-hewm

Percepta MCP Server

by 0x-hewm
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Percepta MCP Server

Python License

基于模型上下文协议（MCP）的强大工具集合，提供浏览器自动化、AI分析、视觉处理、网页爬虫、自动化测试生成和DevTools分析等功能。

本项目专为本地单用户使用设计，不适合公开部署。

快速开始

环境要求

  • Python 3.12+

  • uv (推荐) 或 pip

本地安装运行

# 克隆项目
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

Docker 部署

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件

# 构建并启动
docker-compose up -d

# 查看状态
docker-compose ps
curl http://localhost:8000/health

MCP 客户端配置

Claude Desktop

编辑配置文件 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"]
    }
  }
}

VS Code

配置 settings.json:

{
  "mcp.servers": {
    "percepta-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.percepta_mcp.server"],
      "cwd": "${workspaceFolder}"
    }
  }
}

功能特性

  • 浏览器自动化: 页面导航、元素交互、截图、表单操作

  • AI 智能分析: 支持 OpenAI、Anthropic、Google、Ollama

  • 视觉处理: 图像分析、OCR、对象检测

  • 网页爬虫: 智能数据提取、结构化爬取

  • 自动化测试: AI 驱动的测试用例生成和执行

  • DevTools 分析: 性能监控、异常检测

项目结构

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

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/0x-hewm/percepta-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server