Contextual MCP Server

MCPAI代理

提供方 ContextualAI

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

一个基于Contextual AI的模型上下文协议(MCP)服务器,提供检索增强生成(RAG)能力,支持与多种MCP客户端集成,适用于技术文档查询和智能检索场景。

一句话选型结论

按资料字段整理

Contextual MCP Server 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 20 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

检索增强生成Python本地部署知识库查询上下文感知AI代理技术文档处理

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv .venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Contextual MCP Server当前 1 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ContextualAI上游标注的维护方 ContextualAI
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.3 KB
来自项目仓库与上游目录的原文,未做删改

上下文MCP服务器

一种模型上下文协议(MCP)服务器,使用上下文AI提供RAG(检索增强生成)功能。该服务器与各种MCP客户端集成。它提供了灵活性,您可以决定在服务器中提供什么功能。在本自述文件中,我们将展示与CursorIDE和Claude Desktop的集成。

Contextual AI现在在平台内提供托管服务器,网址为:https://mcp.app.contextual.ai/mcp/\
连接到服务器后,您可以使用平台MCP服务器提供的工具,如查询。\
有关完整的演练,请查看MCP 用户指南.

概述

MCP服务器充当AI接口(Cursor IDE或Claude Desktop)和专用上下文AI代理之间的桥梁。它能够:

  1. 查询处理:将您的特定领域问题交给专门的上下文AI代理
  2. 智能检索:在您的知识库中搜索全面的信息
  3. 上下文感知响应:生成以下答案:
  • 基于源文件
  • 包括引用和归因
  • 保持对话上下文

集成流程```

Cursor/Claude Desktop → MCP Server → Contextual AI RAG Agent
↑ ↓ ↓
└──────────────────┴─────────────┴─────────────── Response with citations


## 先决条件

- Python 3.10或更高版本
- 光标IDE和/或克劳德桌面
- 上下文AI API密钥
- MCP兼容环境

## 安装

1. 克隆存储库:```bash
git clone https://github.com/ContextualAI/contextual-mcp-server.git
cd contextual-mcp-server
  1. 创建并激活虚拟环境:``bash python -m venv .venv source .venv/bin/activate # On Windows, use.venv\Scripts\activate`

3. 安装依赖项:```bash
pip install -e .

配置

配置MCP服务器

服务器需要修改设置或使用。
例如,应该为您的RAG代理定制一个合适的docstring来定制single_agent服务器。

查询工具的文档字符串至关重要,因为它有助于MCP客户端了解何时将问题发送给RAG代理。让它具体到你的知识领域。以下是一个示例:```
A research tool focused on financial data on the largest US firms


或```
A research tool focused on technical documents for Omaha semiconductors

服务器还需要RAG代理进行以下设置:

  • API_KEY:您的上下文AI API密钥
  • AGENT_ID:您的上下文AI代理ID

如果您想将这些文件存储在 .env 你可以这样指定它们:```bash
cat > .env << EOF
API_KEY=key...
AGENT_ID=...
EOF


该仓库还包含更多用于多代理系统的高级MPC服务器或 文件代理人.

### AI接口集成

此MCP服务器可以与各种客户端集成。要与Cursor IDE或Claude Desktop一起使用,请在适当的位置创建或修改MCP配置文件:

1. 首先,找到通往你的道路 `uv` 安装:```bash
UV_PATH=$(which uv)
echo $UV_PATH
# Example output: /Users/username/miniconda3/bin/uv
  1. 使用步骤1中的完整路径创建配置文件:```bash
    cat > mcp.json << EOF
    {
    "mcpServers": {
    "ContextualAI-TechDocs": {
    "command": "$UV_PATH", # make sure this is set properly
    "args": [
    "--directory",
    "\${workspaceFolder}", # Will be replaced with your project path
    "run",
    "multi-agent/server.py"
    ]
    }
    }
    }
    EOF

3. 移动到正确的文件夹位置,请参阅下面的选项:```bash
mkdir -p .cursor/
mv mcp.json .cursor/

配置位置:

  • 对于光标:
  • 项目具体: .cursor/mcp.json 在您的项目目录中
  • 全球的: ~/.cursor/mcp.json 用于全系统访问
  • 对于Claude Desktop:
  • 在相应的Claude Desktop配置目录中使用相同的配置文件格式

环境设置

此项目使用 uv 用于依赖管理,它提供了更快、更可靠的Python包安装。

用法

服务器使用python SDK提供上下文AI RAG功能,可以从MCP客户端(如Cursor IDE和Claude Desktop)访问各种命令。
当前的服务器侧重于使用Contextual AI python SDK中的query命令,但是您可以扩展它以支持其他功能,例如列出所有代理、更新检索设置、更新提示、提取检索或下载指标。

示例用法```python

In Cursor, you might ask:

"Show me the code for initiating the RF345 microchip?"

The MCP client will:

  1. Determine if this should be routed to the MCP Server

Then the MCP server will:

  1. Route the query to the Contextual AI agent
  2. Retrieve relevant documentation
  3. Generate a response with specific citations
  4. Return the formatted answer to Cursor

### 关键利益

1. **准确反应**:所有答案都基于您的文档
1. **消息来源**:每个回复都包括对源文件的引用
1. **情境感知**:系统维护后续问题的对话上下文
1. **实时更新**:响应反映了数据存储中的最新文档

## 发展

### 修改服务器

要添加新功能,请执行以下操作:

1. 通过创建附加功能来添加新工具 `@mcp.tool()`
1. 使用Python类型提示定义工具的参数
1. 提供一个清晰的文档字符串,描述工具的功能

例子:```python
@mcp.tool()
def new_tool(param: str) -&gt; str:
&quot;&quot;&quot;Description of what the tool does&quot;&quot;&quot;
# Implementation
return result

局限性

  • 服务器在本地运行,可能无法在远程开发环境中工作
  • 工具响应受上下文AI API限制和配额的约束
  • 目前仅支持stdio传输模式

有关上下文AI的所有功能,请查看 官方文件.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Contextual MCP Server 怎么安装?

在客户端按下面的安装命令接入:python -m venv .venv。装完在客户端配置里引用同一个包或端点。

Contextual MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Contextual MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Contextual MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Contextual MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Contextual MCP Server 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 上下文感知、检索增强生成、Python、Claude。具体工具清单以官方文档为准。

Contextual MCP Server 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Contextual MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。