太空贸易商MCP服务器
一种用于与客户端交互的模型上下文协议（MCP）服务器 SpaceTraders API该服务器将SpaceTraders API端点公开为MCP工具，允许AI代理管理SpaceTraders宇宙中的代理、车队、合同和交易操作。
概述
该项目提供了一个MCP服务器，使AI代理能够：
- 注册和管理SpaceStraders代理商
- 查看和管理船舶和船队
- 接受、交付和履行合同
- 交易资源并与市场互动
- 探索系统、航路点和造船厂
实施基于 主控程序 标准，使用 mcp 用于服务器基础设施的Python包。
特性
- 注册新的SpaceStraders代理商
- 查看代理详细信息并列出代理
- 列出、查看、接受、交付和履行合同
- 列出船舶、查看船舶详细信息、购买船舶
- 使用船只导航、停靠、绕轨道运行、加油和提取资源
- 转让和出售货物
- 扫描系统、航路点和船只
- 查看市场和造船厂
- 绘制航路点图并优化资源
看 TODO.md 查看已实现和缺失端点的详细清单。
先决条件
- Python 3.12+
- SpaceTraders API密钥（来自https://my.spacetraders.io)
- Docker（可选，用于容器化部署）
安装
使用紫外线
- 如果没有，请安装uv：
pip install uv- 克隆此存储库：
git clone https://github.com/TheValverde/spacetraders-mcp.git
cd spacetraders-mcp- 安装依赖项：
uv pip install -e .- 创建一个
.env文件，并添加您的SpaceTraders API密钥：
SPACETRADERS_API_KEY=your-api-key-here使用Docker（可选）
- 构建Docker镜像：
docker build -t spacetraders-mcp .- 创建一个
.env文件，并添加您的SpaceTraders API密钥。
配置
需要以下环境变量：
| 变量 | 描述 |
|---|---|
SPACETRADERS_API_KEY | 您的SpaceTraders帐户令牌 |
运行服务器
使用紫外线
uv run src/main.py使用Docker
docker run --env-file .env -p 8050:8050 spacetraders-mcpMCP集成
此服务器将SpaceTraders API端点公开为MCP工具。您可以从任何兼容MCP的客户端连接到它。示例配置（根据需要更新URL/端口）：
{
"mcpServers": {
"spacetraders": {
"transport": "sse",
"url": "http://localhost:8050/sse"
}
}
}项目结构
src/main.py--主MCP服务器实现和工具定义src/spacetraders_utils.py-SpaceTraders API客户端和代币管理src/utils.py--实用功能agent_tokens.json--持久代理令牌（自动管理）schemas/-用于SpaceTraders API的OpenAPI和引用JSON文件public/--静态资产TODO.md--端点实施检查表
模式和参考数据
这 schemas/ 目录包含用于参考和开发的大型JSON文件：
schemas/SpaceTraders.json-SpaceTraders API（v2）的官方OpenAPI规范。用于端点参考和验证。schemas/SpaceTraderFullAPI.json--（如果不同，请在此处描述用法，如果不使用，请删除。）
这些文件不是运行服务器所必需的，但对于开发、代码生成和文档编制很有用。
开发状态
看 TODO.md 查看已实现和缺失端点的列表。实现了核心游戏和交易端点；一些高级功能仍然是TODO。
______________________________________________________________________
此项目根据此存储库中包含的LICENSE文件中描述的条款获得许可。