使用说明

项目简介

本项目是一个MCP服务器的示例，它利用AWS Bedrock上的DeepSeek模型，对外提供一系列实用的软件开发辅助工具。该服务器实现了MCP协议，可以与任何兼容MCP协议的客户端进行交互，为开发者提供项目规划、代码生成、代码审查和代码解释等功能。

主要功能点

项目规划：根据用户提供的项目需求和背景信息，生成详细的项目计划，帮助用户更好地组织和管理项目。
代码生成：支持多种编程语言的代码生成，用户只需提供任务描述和目标语言，即可快速生成代码片段。
代码审查：对用户提供的代码进行审查，并根据指定的关注点（如缺陷、性能、安全等）提供专业的代码审查意见。
代码解释：能够对代码进行详细解释，帮助用户理解代码逻辑和功能，支持多种详细程度的解释。
代码重构：根据用户设定的目标（如提高可读性、性能、模块化等），对代码进行重构优化，并提供重构后的代码和修改说明。

安装步骤

环境准备：确保您的机器上已安装 Python 3 环境。
安装依赖：
- 如果仓库中包含 'requirements.txt' 文件，请执行命令 'pip install -r deepseek-planner/requirements.txt' 安装依赖。
- 如果没有 'requirements.txt' 文件，请手动安装必要的依赖包，例如 'mcp-server-sdk', 'boto3', 'python-dotenv' 等。
配置 AWS 凭证：
- 本服务器依赖 AWS Bedrock 服务，您需要配置 AWS 访问凭证才能使用。
- 请设置以下环境变量：
  - 'AWS_ACCESS_KEY_ID': 您的 AWS Access Key ID
  - 'AWS_SECRET_ACCESS_KEY': 您的 AWS Secret Access Key
  - 可选配置 (如果需要)：
    - 'AWS_REGION': AWS 区域，默认为 'us-east-1'
    - 'AWS_SESSION_TOKEN': AWS Session Token (如果使用临时凭证)
启动服务器：
- 运行 'deepseek-planner/src/server.py' 文件即可启动 MCP 服务器。

服务器配置

以下是 MCP 客户端连接本服务器时需要配置的服务器信息（JSON 格式）：

{
  "serverName": "deepseek-planner",
  "command": "python",
  "args": ["deepseek-planner/src/server.py"],
  "description": "DeepSeek Planner MCP Server",
  "transport": "stdio"
}

配置参数说明：

'serverName': 服务器名称，客户端用于标识和管理连接。这里设置为 'deepseek-planner'。
'command': 启动服务器的命令。这里使用 'python' 命令。
'args': 启动命令的参数，指向服务器脚本的路径。这里设置为 'deepseek-planner/src/server.py'。
'description': 服务器的简要描述，方便客户端用户了解服务器功能。
'transport': 服务器使用的传输协议。这里设置为 'stdio'，表示使用标准输入输出进行通信。

注意：MCP 客户端需要根据以上配置信息，才能正确连接到 DeepSeek Planner MCP 服务器并调用其提供的工具。

基本使用方法

启动 MCP 服务器：按照上述步骤启动 'deepseek-planner/src/server.py'。
配置 MCP 客户端：在您的 MCP 客户端中，添加上述服务器配置信息。
调用工具：客户端连接成功后，即可通过 MCP 协议调用服务器提供的工具，例如 'generate_plan'（项目规划）、'generate_code'（代码生成）等，并传递相应的参数以获取服务。

示例工具调用 (假设使用 MCP 客户端的某种方式调用工具)：

项目规划工具 (generate_plan)：

{
  "method": "call",
  "params": {
    "tool_name": "generate_plan",
    "arguments": {
      "requirements": "开发一个智能家居控制系统，用户可以通过手机App控制家中的灯光、电器和安防设备。",
      "format": "markdown"
    }
  }
}

代码生成工具 (generate_code)：

{
  "method": "call",
  "params": {
    "tool_name": "generate_code",
    "arguments": {
      "language": "python",
      "task": "编写一个函数，用于计算两个数的平均值。",
      "comments": true
    }
  }
}

请参考 MCP 协议文档和您的 MCP 客户端使用说明，了解如何发送 MCP 请求和处理响应。

关键词