mentor-mcp-server

一个模型上下文协议服务器，通过 AI 驱动的 Deepseek-Reasoning (R1) 指导能力，为 LLM Agent 提供第二意见，包括代码审查、设计评论、写作反馈以及通过 Deepseek API 进行的创意头脑风暴。通过专家第二意见和可操作的见解，帮助您的 LLM Agent 取得成功。

模型上下文协议

模型上下文协议 (MCP) 实现了以下组件之间的通信：

• 客户端: Claude Desktop、IDE 和其他 MCP 兼容的客户端
• 服务器: 用于任务管理和自动化的工具和资源
• LLM Agent: 利用服务器功能的 AI 模型

目录

• 特性
• 安装
• 配置
• 工具
• 示例
• 开发
• 项目结构
• 许可证

特性

代码分析

• 全面的代码审查
• Bug 检测和预防
• 风格和最佳实践评估
• 性能优化建议
• 安全漏洞评估

设计 & 架构

• UI/UX 设计评论
• 架构图分析
• 设计模式推荐
• 可访问性评估
• 一致性检查

内容增强

• 写作反馈和改进
• 语法和风格分析
• 文档审查
• 内容清晰度评估
• 结构性建议

战略规划

• 功能增强头脑风暴
• 对方法的第二意见
• 创新建议
• 可行性分析
• 用户价值评估

安装

# 克隆仓库
git clone git@github.com:cyanheads/mentor-mcp-server.git
cd mentor-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

添加到您的 MCP 客户端设置：

{
  "mcpServers": {
    "mentor": {
      "command": "node",
      "args": ["build/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "your_api_key",
        "DEEPSEEK_MODEL": "deepseek-reasoner",
        "DEEPSEEK_MAX_TOKENS": "8192",
        "DEEPSEEK_MAX_RETRIES": "3",
        "DEEPSEEK_TIMEOUT": "30000"
      }
    }
  }
}

环境变量

变量名	是否必须	默认值	描述
DEEPSEEK_API_KEY	是	-	您的 Deepseek API 密钥
DEEPSEEK_MODEL	是	deepseek-reasoner	Deepseek 模型名称
DEEPSEEK_MAX_TOKENS	否	8192	每次请求的最大 token 数
DEEPSEEK_MAX_RETRIES	否	3	重试尝试次数
DEEPSEEK_TIMEOUT	否	30000	请求超时时间 (ms)

工具

代码审查

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>code_review</tool_name>
<arguments>
{
  "file_path": "src/app.ts",
  "language": "typescript"
}
</arguments>
</use_mcp_tool>

设计评论

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>design_critique</tool_name>
<arguments>
{
  "design_document": "path/to/design.fig",
  "design_type": "web UI"
}
</arguments>
</use_mcp_tool>

写作反馈

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>writing_feedback</tool_name>
<arguments>
{
  "text": "Documentation content...",
  "writing_type": "documentation"
}
</arguments>
</use_mcp_tool>

功能增强

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>brainstorm_enhancements</tool_name>
<arguments>
{
  "concept": "User authentication system"
}
</arguments>
</use_mcp_tool>

示例

每个工具的详细使用示例和输出可以在 examples 目录中找到：

• 第二意见示例 - 身份验证系统需求分析
• 代码审查示例 - 详细的 TypeScript 代码审查，包含安全性和性能见解
• 设计评论示例 - 针对仪表板设计的全面 UI/UX 反馈
• 写作反馈示例 - 文档改进建议
• 头脑风暴增强示例 - 具有实施细节的功能构思

每个示例都包含请求格式和示例响应，展示了工具的功能和输出结构。

开发

# 构建 TypeScript 代码
npm run build

# 启动服务器
npm run start

# 使用 watch 模式进行开发
npm run dev

# 清理构建产物
npm run clean

项目结构

src/
├── api/         # API 集成模块
├── tools/       # 工具实现
│   ├── second-opinion/
│   ├── code-review/
│   ├── design-critique/
│   ├── writing-feedback/
│   └── brainstorm-enhancements/
├── types/       # TypeScript 类型定义
├── utils/       # 实用函数
├── config.ts    # 服务器配置
├── index.ts     # 入口点
└── server.ts    # 主要服务器实现

许可证

Apache License 2.0。 有关更多信息，请参见 LICENSE。

---

<div align="center"> 基于模型上下文协议构建 </div>