🚀 上下文MCP服务器

这是一个具备检索增强生成（RAG）功能的Model Context Protocol（MCP）服务器，借助Contextual AI实现。该服务器能够与多种MCP客户端集成，本说明文档将着重展示其与Cursor IDE和Claude Desktop的集成方式。

🚀 快速开始

此MCP服务器在AI接口（如Cursor IDE或Claude Desktop）和专门的Contextual AI代理之间搭建了桥梁，主要实现以下功能：

1. 查询处理：将您的领域特定问题直接发送到专用的Contextual AI代理。
2. 智能检索：在知识库中通过全面的信息进行搜索。
3. 上下文感知响应：生成的回答根基于源文档，包含引用和attribution，并且维持对话上下文。

集成流程

Cursor/Claude Desktop → MCP Server → Contextual AI RAG Agent
        ↑                  ↓             ↓                         
        └──────────────────┴─────────────┴───────────────带引用的响应

✨ 主要特性

• 作为AI接口与Contextual AI代理的桥梁，实现高效交互。
• 具备查询处理、智能检索和上下文感知响应等核心功能。
• 可与Cursor IDE和Claude Desktop等多种MCP客户端集成。

📦 安装指南

先决条件

• Python 3.10或更高版本
• Cursor IDE和/或Claude Desktop
• Contextual AI API密钥
• MCP兼容环境

安装步骤

1. 克隆仓库：

git clone https://github.com/ContextualAI/contextual-mcp-server.git
cd contextual-mcp-server

2. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # Windows上使用`.venv\Scripts\activate`

3. 安装依赖项：

pip install -r requirements.txt

📚 详细文档

配置

要修改服务器设置，可按以下步骤操作：

1. 在config.py中添加或修改以下内容：

   # 示例配置
   API_KEY = "your_api_key"
   AGENT_ID = "your_agent_id"
   

2. 使用.env文件存储API密钥和AGENT_ID：

   export API_KEY=your_api_key
   export AGENT_ID=your_agent_id
   

AI接口集成

要为Cursor IDE或Claude Desktop配置服务器，可按以下步骤操作：

1. 找到uv路径：

which uv  # 或者 locate uv

2. 创建并编辑config.json文件，添加以下内容：

   {
     "server": {
       "host": "localhost",
       "port": 8000
     },
     "tools": {
       "tool1": {
         "command": "python tool.py"
       }
     }
   }
   

环境设置

使用uv进行依赖管理：

uv init --python
uv run myapp

💻 使用示例

基础用法

在Cursor中提问示例：

# 示例问题
server.get_current_time()

服务器处理流程

1. 收到查询请求。
2. 解析并执行工具函数。
3. 返回结果。

🔧 技术细节

修改服务器

要添加新功能，可按以下步骤操作：

1. 添加新工具，通过创建额外函数并使用@mcp.tool()装饰器：

   @mcp.tool()
   def new_tool(param: str) -> str:
       """描述工具的功能"""
       # 实现代码
       return 结果
   

📄 许可证

有关Contextual AI的所有功能，请参考官方文档。

⚠️ 重要提示

• 服务器在本地运行，可能无法在远程开发环境中使用。
• 工具响应受Contextual AI API限制和配额影响。
• 当前仅支持stdio传输模式。