Cerevox MCP Server

Cerevox MCP 服务器

模型上下文协议（MCP）服务器用于 Cerevox AI（可译为“赛瑞沃克斯人工智能”或根据具体语境简化为“赛瑞沃克斯AI”） - 人工智能代理的数据层。

这个MCP服务器通过模型上下文协议暴露了完整的Cerevox API套件，使AI代理能够：

• 解析文档 凭借行业领先的准确度（Lexa API）
• 搜索和查询 结合全局信息和原文内容，译文应为：“结合RAG的文档集合（Hippo API）”
• 管理账户 和用户（账户API）

特点/功能

Lexa - 文档解析

• 使用AI驱动的提取技术从URL解析文档
• 支持PDF、DOCX、TXT、HTML及12+种格式
• 提取文本、表格、图像和元数据
• 实时监控处理任务

Hippo - RAG（检索增强生成）与语义搜索

• 创建和管理文档文件夹
• 从URL上传文件以进行处理
• 创建问答聊天会话
• 使用AI提供答案和来源引用来提问
• 检索对话历史
• 管理文件和文件夹

账户 - 用户管理

• 获取账户信息和使用指标
• 查看计划详情和限制
• 列出并管理用户
• 追踪API使用情况和账单

安装

先决条件

• Python 3.9或更高版本
• Cerevox API密钥（在这里获取一个)

从源代码安装

# Clone the repository
git clone https://github.com/CerevoxAI/cerevox-mcp-server.git
cd cerevox-mcp-server

# Install in development mode
pip install -e .

从PyPI安装（即将推出）

pip install cerevox-mcp-server

配置

设置您的API密钥

服务器需要一个Cerevox API密钥。将其设置为环境变量：

export CEREVOX_API_KEY="your-api-key-here"

或者将其添加到您的shell配置文件中（~/.bashrc， ~/.zshrc等。）:

echo 'export CEREVOX_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

使用Claude桌面版进行配置

将此添加到您的Claude桌面配置文件中：

macOS（苹果电脑操作系统）: ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cerevox": {
      "command": "python",
      "args": ["-m", "cerevox_mcp_server"],
      "env": {
        "CEREVOX_API_KEY": "your-api-key-here"
      }
    }
  }
}

与其他MCP客户端进行配置

对于其他MCP客户端，请参阅其文档以了解如何连接到MCP服务器。通常，您需要：

1. 将客户端指向服务器： python -m cerevox_mcp_server
2. 确保 CEREVOX_API_KEY 环境变量已设置

使用示例

使用Lexa进行文档解析

解析文档并提取结构化内容：

Use the lexa_parse_document tool to parse this PDF: https://example.com/document.pdf

人工智能将从文档中提取文本、表格和元数据。

使用Hippo进行RAG搜索

创建文件夹，上传文件，并提出问题：

1. Create a folder called "research_papers" with ID "research"
2. Upload this file: https://arxiv.org/pdf/2301.00001.pdf
3. Create a chat session for the "research" folder
4. Ask: "What are the main findings of this paper?"

人工智能将：

1. 创建文件夹
2. 上传并处理该文件
3. 创建一个聊天会话
4. 使用带有来源引用的RAG（检索增强生成）来回答你的问题

账户管理

检查您的账户使用情况：

1. Get my account information
2. Show my usage metrics
3. List all users in the account

可用工具

Lexa 工具

Hippo文件夹工具

Hippo文件工具

Hippo Chat/问答工具

账户工具

| 获取当前用户信息 |

发展

# Clone and install with dev dependencies
git clone https://github.com/CerevoxAI/cerevox-mcp-server.git
cd cerevox-mcp-server
pip install -e ".[dev]"

设置开发环境

pytest

运行测试

black src/

代码格式化

mypy src/

类型检查

建筑

• 服务器构建于： MCP Python SDK（MCP Python软件开发工具包）
• - 模型上下文协议实现 Cerevox-Python
• - 官方Cerevox Python SDK AsyncIO（异步I/O）

- 异步操作以实现最佳性能

工具设计

1. 每种工具都遵循一种一致的模式： 输入验证
2. - 验证必需参数 客户端初始化
3. - 重用已验证的客户端 API调用
4. 执行Cerevox API操作 响应格式化
5. - 返回结构化的JSON响应 错误处理

- 提供清晰的错误信息

认证

• 服务器自动处理身份验证： CEREVOX_API_KEY API密钥已从加载
• 环境变量
• 客户端在首次使用时按需初始化
• 为保持最佳性能而持续维护会话

由cerevox-python SDK自动处理令牌刷新

故障排除

“CEREVOX_API_KEY 环境变量未设置”

export CEREVOX_API_KEY="your-api-key-here"

确保你已经设置了环境变量：

“连接被拒绝”或“服务器无响应”

确保MCP服务器正在运行，并且您的客户端配置正确。检查日志以获取详细的错误信息。

“认证失败”

请验证您的API密钥是否有效且具有必要的权限。如需获取新密钥，请访问https://cerevox.ai

文档解析速度慢 lexa_get_job_status 大型文档的处理可能需要几分钟时间。请使用

用于监控进度的工具。

示例

# This would be done through an MCP client like Claude Desktop

# 1. Create a folder for your documents
"Create a Hippo folder with ID 'my_docs' and name 'My Documents'"

# 2. Upload documents
"Upload https://example.com/report.pdf to the 'my_docs' folder"

# 3. Wait for processing (check file status)
"List files in the 'my_docs' folder to check processing status"

# 4. Create a chat session
"Create a chat session for the 'my_docs' folder"

# 5. Ask questions
"Ask in chat [chat_id]: What are the key recommendations in the report?"

# 6. Follow-up questions
"Ask in chat [chat_id]: Can you elaborate on the financial projections?"

# 7. Get conversation history
"Show me the conversation history for chat [chat_id]"

完整的RAG工作流程

# Parse a document and analyze its content
"Parse this document: https://example.com/contract.pdf using advanced mode"

# The response will include:
# - Extracted text content
# - Number of pages
# - Number of tables found
# - Content preview

文档分析

# Check account status and usage
"Get my account information"
"Show my usage metrics"
"What's my current plan and its limits?"

账户监控

• 支持文档
• https://docs.cerevox.ai 的中文翻译可以是：“https://cerevox.ai 的文档” 或者 “Cerevox AI 的官方文档页面”。这里，“docs”通常代表“文档”（documents）的意思，所以直接翻译为“文档”即可。同时，保持网址的原样，因为网址本身是不需要翻译的GitHub Issues（GitHub问题）
• https://github.com/CerevoxAI/cerevox-mcp-server/issues 的中文翻译为：“https://github.com/CerevoxAI/cerevox-mcp-server/issues（CerevoxAI的cerevox-mcp-server项目的问题页面）”。不过，通常在中文语境下，我们可能会简化为“CerevoxAI的cerevox-mcp-server项目问题页面”，或者直接保留原网址，因为网址本身已经具有明确的指向性Discord（一款即时通讯和视频聊天软件）
• https://discord.gg/cerevox（直接翻译为中文网址形式，保持原样）电子邮件

support@cerevox.ai（可翻译为：“支持邮箱：support@cerevox.ai” 或简化为 “联系邮箱：support@cerevox.ai”，具体根据语境选择）

贡献；助力 我们欢迎投稿！请参阅我们的 贡献指南

详情请见。

许可证 这个项目遵循MIT许可证授权 - 请参阅 许可证

详情请查阅文件。

• 链接
• Cerevox AI（可译为“Cerevox人工智能”或根据具体语境简化为“Cerevox智脑”等，但直接翻译为“Cerevox人工智能”是最直观的表达）
• Cerevox Python SDK（软件开发工具包）
• 模型上下文协议

______________________________________________________________________

MCP Python SDK（MCP Python软件开发工具包）

由Cerevox团队用心打造