mentor-mcp-server

mentor-mcp-server

一个 Model Context Protocol 服务，通过 Deepseek API 提供 AI 驱动的 Deepseek-Reasoning（R1）指导能力，让大模型 Agent 获得第二意见，涵盖代码审查、设计评议、写作反馈和创意头脑风暴。通过专家的第二意见和可执行的见解，助力大模型 Agent 取得成功。

Model Context Protocol

Model Context Protocol（MCP）支持以下各方之间的通信：

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

目录

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

功能

代码分析

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

设计与架构

• 评议 UI/UX 设计
• 分析架构图
• 推荐设计模式
• 评估无障碍性
• 检查一致性

内容优化

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

战略规划

• 针对功能增强展开头脑风暴
• 对方案提供第二意见
• 提出创新建议
• 分析可行性
• 评估用户价值

安装

# Clone the repository
git clone [email protected]:cyanheads/mentor-mcp-server.git
cd mentor-mcp-server

# Install dependencies
npm install

# Build the project
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	请求超时时间（毫秒）

工具

代码审查

<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 反馈
• 写作反馈示例 - 提供文档改进建议
• 头脑风暴增强方案示例 - 构思功能并提供实现细节

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

开发

# Build TypeScript code
npm run build

# Start the server
npm run start

# Development with watch mode
npm run dev

# Clean build artifacts
npm run clean

项目结构

src/
├── api/         # API integration modules
├── tools/       # Tool implementations
│   ├── second-opinion/
│   ├── code-review/
│   ├── design-critique/
│   ├── writing-feedback/
│   └── brainstorm-enhancements/
├── types/       # TypeScript type definitions
├── utils/       # Utility functions
├── config.ts    # Server configuration
├── index.ts     # Entry point
└── server.ts    # Main server implementation

许可证

Apache License 2.0。更多信息请参阅 LICENSE。

---