开发者指南¶

本指南为希望理解、修改或贡献 MiniMax-MCP 服务器代码的开发者提供信息。

注意: 部分信息基于初步的代码结构观察，详细信息可能需要更深入的研究。

环境设置¶

依赖管理: 项目使用 uv 作为 Python 包管理器。主要的依赖项定义在 pyproject.toml 文件中，而 uv.lock 文件锁定了精确的依赖版本。

安装开发依赖: 进入项目根目录后，可能需要运行类似以下命令来创建虚拟环境并安装所有依赖（包括开发依赖）：

uv venv  # 创建虚拟环境 (.venv)
uv sync --dev # 安装所有依赖
source .venv/bin/activate # 激活虚拟环境 (Linux/macOS)
# 或者 .venv\Scripts\activate (Windows)

自动化脚本: scripts/ 目录包含一些有用的脚本：
- dev.sh: 可能用于快速设置开发环境或启动开发模式的服务器。
- setup.sh: 可能用于执行一次性的初始设置。
- build.sh: 用于构建项目（例如，打包发布）。
- deploy.sh: 用于部署项目。
- test.sh: 用于运行单元测试。请检查这些脚本的具体内容以了解其确切功能。

来源：README.md, 仓库文件结构

项目的代码组织结构遵循标准的 Python 项目布局：

minimax_mcp/: 包含核心的 Python 源代码。
- __init__.py: 包初始化文件。
- __main__.py: 作为包执行时的入口点 (例如 python -m minimax_mcp)。
- server.py: 核心文件，实现了 MCP 服务器的主要逻辑，定义了所有可用的工具及其与 MiniMax API 的交互。
- client.py: 可能包含了调用 MiniMax API 的底层客户端类或函数。
- utils.py: 包含项目共享的实用工具函数。
- const.py: 定义了项目中使用的常量。
- exceptions.py: 定义了自定义的异常类。
scripts/: 包含上述提到的自动化 Shell 脚本。
tests/: 包含单元测试和集成测试。
- conftest.py: pytest 的配置文件，用于设置测试环境和 fixtures。
- test_*.py: 具体的测试用例文件 (例如 test_utils.py)。
根目录文件:
- pyproject.toml: 项目元数据和依赖项定义 (遵循 PEP 621)。
- setup.py: (可能为了兼容性保留) 旧式的项目构建文件。
- uv.lock: 锁定的依赖版本文件。
- README.md, README-CN.md: 项目说明文档。
- .env.example: 环境变量示例文件。
- mcp_server_config_demo.json: MCP 服务器配置示例 (可能用于测试或文档)。
- LICENSE: 项目的开源许可证文件 (MIT)。
- .gitignore: 指定 Git 应忽略的文件和目录。

来源：仓库文件结构, server.py

增加日志级别: 设置 MINIMAX_MCP_LOG_LEVEL 环境变量为 DEBUG 可以获取更详细的服务器运行日志，有助于追踪问题。
```
export MINIMAX_MCP_LOG_LEVEL=DEBUG
# 然后启动服务器
```
直接运行模块: 可以尝试直接运行服务器模块进行调试（确保已设置必要的环境变量）：
```
python -m minimax_mcp [options]
```
单元测试: 编写和运行单元测试是调试特定模块功能的好方法。使用 pytest 运行测试：
```
pytest tests/
# 或者使用脚本
./scripts/test.sh
```

来源：server.py (提及日志级别环境变量), 仓库文件结构

来源：仓库文件结构

目前仓库的 README.md 文件中没有明确的贡献指南。如果您希望为项目贡献代码，建议：