Aurai Advisor (上级顾问 MCP)

MCP开发工具

提供方 LZMW

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

MCP服务为本地AI提供远程大模型咨询支持,适用于复杂编程问题的多轮迭代解决。

一句话选型结论

按资料字段整理

Aurai Advisor (上级顾问 MCP) 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

编程辅助Python本地部署AI咨询代码分析多轮会话上下文同步

安装与配置

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

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

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Aurai Advisor (上级顾问 MCP)当前 4 stdio · 本地进程 支持远程部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

上级顾问 MCP(Aurai Advisor)

> 让本地 AI 在遇到复杂编程问题时,向远程大模型继续请教的 MCP 服务。

当前仓库对应的是“可长期使用”的版本,已经补齐了这些关键能力:

  • 多轮咨询与进度回报
  • sync_context 文件同步
  • 代码/配置文件自动转文本上传
  • 会话隔离(session_id)
  • 历史持久化、文件锁、原子写入
  • 历史自动摘要
  • 上下文窗口裁剪

本次更新了什么

这次主线更新,重点补的是这些:

  • 修复历史清空后重启又“复活”的问题
  • 增加 session_id 会话隔离,避免不同问题串上下文
  • 接通 AURAI_TEMPERATURE、AURAI_MAX_ITERATIONS、AURAI_LOG_LEVEL 等真实可用配置
  • 让 project_info、补充回答等上下文真正发给上级顾问
  • 增加历史文件锁和原子写入,降低并发写坏历史文件的风险
  • 增加历史自动摘要,长会话不会越来越臃肿
  • 增加上下文窗口裁剪,AURAI_CONTEXT_WINDOW 现在会真正生效
  • sync_context 支持自动把代码/配置等文本文件转成可发送文本,不再要求手动复制成 .txt
  • 重写 README、安装指南和用户手册,安装步骤现在放在更靠前的位置

如果你是第一次接触这个仓库,最重要的两点是:

  1. 先看下面的“安装说明”
  2. 代码文件现在可以直接传给 sync_context

适合做什么

这个 MCP 适合放在 Claude Code 或其他支持 stdio 方式的 MCP 客户端里使用。

典型场景:

  • 本地 AI 已经尝试过,但问题还是没解开
  • 需要把报错、代码、文档、配置一起交给“上级顾问”
  • 希望让复杂排查变成“提问 -> 执行 -> 汇报 -> 下一步”的多轮流程

功能概览

  • consult_aurai
    主要咨询工具。提交问题、代码片段、上下文、已尝试方案,获取上级顾问的分析和下一步建议。

  • sync_context
    同步代码和文档上下文。
    现在不只支持 .txt/.md,还会自动把 .py/.js/.ts/.json/.yaml/.toml/.ini 等文本文件转成适合发送的文本内容。

  • report_progress
    把执行结果回报给上级顾问,继续下一轮迭代。

  • get_status
    查看当前会话状态、历史数量、模型与历史文件路径。


安装说明

更详细的安装步骤见:

  • Claude Code 安装指南
  • 用户手册

这里先给一份最常用的安装流程。

1. 准备环境```bash

需要 Python 3.10+

python --version

进入仓库目录

cd G:\codex\mcp-aurai-server


### 2. 创建虚拟环境并安装依赖```bash
python -m venv venv
venv\Scripts\activate
pip install -e ".[all-dev]"

3. 在 Claude Code 中注册 MCP```bash

claude mcp add --scope user --transport stdio aurai-advisor ^
--env AURAI_API_KEY="your-api-key" ^
--env AURAI_BASE_URL="https://api.example.com/v1" ^
--env AURAI_MODEL="gpt-4o" ^
-- "G:\codex\mcp-aurai-server\venv\Scripts\python.exe" "-m" "mcp_aurai.server"


说明:

- `AURAI_BASE_URL` 必须是 OpenAI 兼容接口地址
- 当前版本只保留 `custom` 方式,不再使用旧的 `AURAI_PROVIDER`
- `--scope user` 表示在所有项目里都可用,最省心

### 4. 验证安装```bash
claude mcp list
pytest

预期:

  • claude mcp list 能看到 aurai-advisor
  • pytest 通过

快速使用

场景 1:直接咨询问题```python

consult_aurai(
problem_type="runtime_error",
error_message="启动时报 KeyError: api_key",
code_snippet="config = load_config()\napi_key = config['api_key']",
context={
"file_path": "src/config.py",
"terminal_output": "Traceback ...",
}
)


### 场景 2:先上传代码文件,再咨询```python
sync_context(
operation="incremental",
files=["src/main.py", "config/settings.json", "README.md"],
project_info={
"project_name": "My Project",
"tech_stack": "Python + FastAPI"
}
)

consult_aurai(
problem_type="runtime_error",
error_message="请结合已同步文件帮我排查启动失败"
)

注意:

  • 不需要再手动把 main.py 复制成 main.txt
  • 文本代码文件会自动转成文本发送
  • 二进制文件会被跳过

场景 3:多问题并行,使用会话隔离```python

consult_aurai(
problem_type="runtime_error",
error_message="问题 A",
session_id="issue-a"
)

consult_aurai(
problem_type="design_issue",
error_message="问题 B",
session_id="issue-b"
)


这能避免不同问题互相串台。

---

## sync_context 文件上传规则

### 会直接发送的

- `.md`、`.markdown`、`.mdx`
- `.txt`
- 各类代码与配置文本文件,例如:
- `.py` `.js` `.ts` `.tsx`
- `.json` `.yaml` `.yml` `.toml`
- `.ini` `.cfg` `.env`
- `.java` `.go` `.rs` `.cpp` `.cs`

### 会自动转换的

- 不是 `.txt/.md`,但内容是文本的文件
- 会自动生成一个 `.txt` 或 `.md` 的发送名
- 会在内容前附带“原始文件路径”和“自动转换后的发送名”

### 会跳过的

- 图片
- 压缩包
- 音视频
- 可执行文件
- 明显的二进制内容

如果一批文件里既有代码又有图片:

- 代码照常上传
- 图片会被记为 `skipped_files`
- 整次同步仍然成功

---

## 环境变量

### 必填

| 变量 | 说明 |
|------|------|
| `AURAI_API_KEY` | API 密钥 |
| `AURAI_BASE_URL` | OpenAI 兼容接口地址 |
| `AURAI_MODEL` | 模型名称 |

### 常用可选项

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `AURAI_TEMPERATURE` | 温度 | `0.7` |
| `AURAI_MAX_ITERATIONS` | 最大迭代轮数 | `10` |
| `AURAI_MAX_HISTORY` | 每个会话保留的历史条数上限 | `50` |
| `AURAI_CONTEXT_WINDOW` | 总上下文窗口大小 | `200000` |
| `AURAI_MAX_MESSAGE_TOKENS` | 单条大文件消息大小上限 | `150000` |
| `AURAI_MAX_TOKENS` | 最大输出长度 | `32000` |
| `AURAI_LOG_LEVEL` | 日志级别 | `INFO` |
| `AURAI_ENABLE_PERSISTENCE` | 是否持久化历史 | `true` |
| `AURAI_HISTORY_PATH` | 默认会话历史文件路径 | `~/.mcp-aurai/history.json` |
| `AURAI_HISTORY_LOCK_TIMEOUT` | 历史文件锁等待时间(秒) | `10` |
| `AURAI_ENABLE_HISTORY_SUMMARY` | 是否启用历史摘要 | `true` |
| `AURAI_HISTORY_SUMMARY_KEEP_RECENT` | 摘要后保留的最近原始轮数 | `3` |
| `AURAI_HISTORY_SUMMARY_TRIGGER` | 触发摘要的原始记录阈值 | `8` |

---

## 当前版本的关键行为

### 1. 会话隔离

- 每个 `session_id` 都有各自的历史
- 默认不传时使用 `default`
- 不同会话会落到不同历史文件,避免串会话

### 2. 历史摘要

- 较早历史会自动压成一条“历史摘要”
- 最近几轮和最近一次 `sync_context` 会尽量保留原样
- 这样能减少上下文占用,给当前问题腾空间

### 3. 上下文窗口裁剪

- 会优先保留系统提示
- 优先保留最近一次 `sync_context`
- 再尽量保留最近历史轮次
- 必要时自动收缩本次输出长度,避免总窗口超限

### 4. 历史文件更稳

- 保存历史时使用锁文件避免并发写坏
- 写入采用临时文件再替换,避免留下半截 JSON

---

## 测试```bash
pytest

当前主线覆盖的重点包括:

  • 历史清空与持久化
  • 会话隔离
  • 自动文本转换上传
  • 历史锁与原子写
  • 历史摘要
  • 上下文窗口裁剪

文档

  • Claude Code 安装指南
  • 用户手册
  • 开发文档

常见问题

为什么上级顾问没收到我上传的代码文件?

旧版本要求先手动转成 .txt。当前版本已经支持自动转换文本文件。

如果还是没收到,优先检查:

  • 文件路径是否存在
  • 文件是不是二进制
  • sync_context 返回里的 uploaded_files / skipped_files

为什么不同问题会互相影响?

如果你希望完全隔离,给不同问题传不同 session_id。

为什么历史文件看起来变短了?

这是历史摘要在工作。旧历史被压成纪要,不是丢了,而是换成更省上下文的“会议纪要”。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Aurai Advisor (上级顾问 MCP) 怎么安装?

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

Aurai Advisor (上级顾问 MCP) 怎么在 Claude 里配置?

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

Aurai Advisor (上级顾问 MCP) 收费吗?

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

Aurai Advisor (上级顾问 MCP) 需要 API Key 吗?

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

Aurai Advisor (上级顾问 MCP) 支持哪些客户端?

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

Aurai Advisor (上级顾问 MCP) 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 编程辅助、代码分析、Python、Claude。具体工具清单以官方文档为准。

Aurai Advisor (上级顾问 MCP) 需要什么运行环境?

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

Aurai Advisor (上级顾问 MCP) 是本地还是远程?

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

热门专题

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

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