Screeps MCP 服务器

一个用于与Screeps游戏API交互的Model Context Protocol (MCP)服务器。

该项目提供了一个符合MCP标准的服务器，该服务器将Screeps游戏数据和操作作为MCP工具和资源公开。它使大型语言模型或其他MCP客户端能够以结构化、协议驱动的方式访问、查询和操作Screeps游戏账户和数据。

项目目的

• 连接Screeps和AI/LLM工具： 允许大型语言模型和其他MCP客户端通过标准协议与Screeps游戏进行交互。
• 公开Screeps API作为MCP工具/资源： 使玩家信息、游戏数据和其他Screeps API特性可以通过MCP访问。
• 支持多种Screeps服务器类型： 通过配置支持官方、私人和Steam服务器。

特性

• 符合MCP标准的服务器： 实现了Model Context Protocol，便于与LLMs和其他客户端集成。
• Screeps API集成： 使用令牌或用户名/密码安全地连接到Screeps服务器。
• MCP工具： 示例：getPlayerInfo检索认证玩家的信息（用户名、GCL）。
• 可扩展性： 容易添加新的MCP工具/资源以支持更多的Screeps API端点。
• 可配置性： 通过环境变量支持官方、私人和Steam Screeps服务器。

快速开始

1. 安装依赖

npm install

2. 构建服务器

npm run build

3. 配置环境变量

根据需要设置以下变量：

• SCREEPS_API_TOKEN（推荐）或 SCREEPS_USERNAME 和 SCREEPS_PASSWORD
• SCREEPS_SERVER_TYPE (official, private, 或 steam)
• SCREEPS_PRIVATE_HOST, SCREEPS_PRIVATE_PORT, SCREEPS_PRIVATE_SECURE（针对私人/Steam服务器）

示例：

export SCREEPS_API_TOKEN=your_token
export SCREEPS_SERVER_TYPE=official

4. 运行服务器

npm start

服务器将启动并监听通过stdio的MCP协议请求。

配置

所有配置均通过环境变量完成。详情见 src/config/index.ts。

• LOG_LEVEL（默认值：info）
• SCREEPS_API_TOKEN 或 SCREEPS_USERNAME/SCREEPS_PASSWORD
• SCREEPS_SERVER_TYPE: official, private, 或 steam
• SCREEPS_PRIVATE_HOST, SCREEPS_PRIVATE_PORT, SCREEPS_PRIVATE_SECURE: 针对私人/Steam服务器

MCP工具及资源

示例工具：getPlayerInfo

检索认证的Screeps玩家的用户名和GCL（全球控制级别）。

请求：

• 工具名称：getPlayerInfo
• 不需要参数

响应：

{
  "username": "your_username",
  "gcl": 123456
}

更多工具和资源可以通过扩展代码库来添加（参见 src/tools/）。

集成

Claude Desktop

要将此服务器与Claude Desktop一起使用，请在您的Claude配置中添加以下内容：

在macOS上：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "screeps": {
      "command": "/path/to/screeps-mcp-server/build/index.js"
    }
  }
}

调试

为了调试MCP协议流量，请使用MCP Inspector：

npm run inspector

这将提供一个基于浏览器的界面，用于检查MCP请求和响应。

开发

• 使用 npm run watch 在开发期间自动重建。
• 代码组织清晰且易于维护。主要逻辑位于 src/ 中。
• 欢迎贡献！

许可证

MIT