Skip to main content
Glama

World of Warships Ship Data MCP

by amxkifir
GitHub
Python
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

World of Warships Ship Data MCP Tool

重要声明

⚠️ 本工具仅供学习和研究目的使用

  • 本工具使用Wargaming.net公开API获取《战舰世界》舰船数据

  • 请严格遵守Wargaming.net开发者条款

  • 禁止将本工具用于商业用途或违反游戏服务条款的行为

  • 使用本工具即表示您同意承担相应的法律责任

使用限制

  • 非商业使用: 本工具仅限个人学习和非商业研究使用

  • API配额: 请合理使用API，避免过度请求导致配额耗尽

  • 数据准确性: API数据可能存在延迟或不准确，请以游戏内实际数据为准

  • 服务可用性: Wargaming API服务可能因维护或其他原因暂时不可用

数据使用声明

本工具通过Wargaming.net官方API获取数据，所有舰船数据版权归Wargaming.net所有。用户在使用本工具时应：

  1. 遵守Wargaming.net的使用条款和隐私政策

  2. 不得将获取的数据用于商业目的

  3. 不得恶意请求或滥用API服务

  4. 尊重游戏开发商的知识产权

一个强大的MCP（Model Context Protocol）工具，用于获取《战舰世界》游戏中的舰船数据。通过Wargaming.net官方API提供准确、实时的舰船信息。

功能特性

  • 🔍 舰船搜索: 根据舰船名称快速搜索

  • 📊 详细信息: 获取舰船的完整技术参数和历史信息

  • ⚖️ 舰船对比: 同时对比多艘舰船的性能参数

  • 🌍 多语言支持: 支持多种语言的舰船信息

  • 🏴 按国家筛选: 获取特定国家的所有舰船

  • 🚢 按类型筛选: 按驱逐舰、巡洋舰、战列舰、航母分类

  • 📈 按等级筛选: 获取特定等级的舰船信息

  • 💾 智能缓存: 自动缓存API响应，提高性能

  • 🔧 错误处理: 完善的错误处理和重试机制

安装和配置

环境变量设置

  1. 复制环境变量模板:

    cp .env.example .env

  2. 编辑 .env 文件，添加您的 Wargaming API 密钥:

    WARGAMING_API_KEY=your_actual_api_key_here WOWS_REALM=asia WOWS_LANGUAGE=zh-cn

  3. 设置系统环境变量 (推荐):

    Windows:

    setx WARGAMING_API_KEY "your_actual_api_key_here"

    macOS/Linux:

    export WARGAMING_API_KEY="your_actual_api_key_here" # 添加到 ~/.bashrc 或 ~/.zshrc 以持久化 echo 'export WARGAMING_API_KEY="your_actual_api_key_here"' >> ~/.bashrc

Claude Desktop 配置

在 Claude Desktop 配置文件中添加以下内容:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": { "wows-ship-mcp": { "command": "python", "args": ["path/to/wows-ship-mcp/src/server.py"], "env": { "WARGAMING_API_KEY": "${WARGAMING_API_KEY}" } } } }

重要: 将 path/to/wows-ship-mcp 替换为项目的实际绝对路径。

安全注意事项

  • ✅ 使用环境变量存储 API 密钥

  • ✅ .env 文件已被 git 忽略，不会被推送到远程仓库

  • ✅ claude_desktop_config.json 也被忽略以防止意外暴露密钥

  • ❌ 永远不要将真实的 API 密钥提交到版本控制系统

故障排除

常见问题

  1. API密钥无效

    • 检查环境变量WARGAMING_API_KEY是否正确设置

    • 确认API密钥在Wargaming开发者门户中有效

  2. 网络连接问题

    • 检查网络连接

    • 确认防火墙没有阻止API请求

  3. 缓存问题

    • 使用cleanup_cache工具清理过期缓存

    • 删除cache目录重新开始

可用工具

1. search_ships

搜索舰船

  • search_term: 舰船名称或部分名称

  • limit: 返回结果数量限制（默认20）

  • language: 结果语言（默认en）

2. get_ship_details

获取舰船详细信息

  • ship_id: 舰船ID

  • language: 结果语言（默认en）

3. get_ship_parameters

获取舰船战斗参数

  • ship_id: 舰船ID

  • language: 结果语言（默认en）

4. compare_ships

对比多艘舰船

  • ship_ids: 舰船ID列表（2-5艘）

  • language: 结果语言（默认en）

5. get_ships_by_nation

按国家获取舰船

  • nation: 国家名称

  • language: 结果语言（默认en）

  • limit: 返回数量限制（默认50）

  • offset: 分页偏移量（默认0）

6. get_ships_by_type

按类型获取舰船

  • ship_type: 舰船类型（Destroyer/Cruiser/Battleship/AirCarrier）

  • language: 结果语言（默认en）

  • limit: 返回数量限制（默认50）

  • offset: 分页偏移量（默认0）

7. get_ships_by_tier

按等级获取舰船

  • tier: 舰船等级（1-11）

  • language: 结果语言（默认en）

  • limit: 返回数量限制（默认50）

  • offset: 分页偏移量（默认0）

8. cleanup_cache

清理缓存

  • 清理过期的缓存条目

  • 返回清理统计信息

安装和使用

1. 克隆仓库

git clone https://github.com/amxkifir/wows-ship-mcp.git cd wows-ship-mcp

2. 安装依赖

pip install -r requirements.txt

3. 配置Claude Desktop

在Claude Desktop配置文件中添加以下配置：

{ "mcpServers": { "wows-ship-mcp": { "command": "python", "args": ["/path/to/your/wows-ship-mcp/src/server.py"], "env": { "WARGAMING_API_KEY": "your_api_key_here" } } } }

环境变量配置

创建.env文件或设置环境变量：

# Windows set WARGAMING_API_KEY=your_api_key_here # Linux/Mac export WARGAMING_API_KEY=your_api_key_here

JSON配置方式

也可以使用JSON配置文件config.json：

{ "api_key": "your_api_key_here", "language": "en", "cache_ttl": 3600, "max_retries": 3, "request_timeout": 30 }

传统方式

如果您使用传统的MCP服务器配置，请在Claude Desktop配置中添加：

{ "mcpServers": { "wows-ship-mcp": { "command": "python", "args": ["/path/to/your/wows-ship-mcp/src/server.py"], "env": { "WARGAMING_API_KEY": "your_api_key_here" } } } }

获取API密钥

  1. 访问Wargaming开发者门户

  2. 注册或登录您的账户

  3. 创建新的应用程序

  4. 获取您的API密钥

申请API密钥时请注意：

  • 详细说明您的使用目的（学习、研究等）

  • 确保用途符合Wargaming开发者条款

  • 避免提及任何商业用途

  • 说明您将遵守API使用限制和条款

使用方法

作为MCP服务器

配置完成后，在Claude Desktop中即可使用所有工具。例如：

  • "搜索大和号战列舰"

  • "获取俾斯麦号的详细参数"

  • "对比衣阿华和大和的性能"

  • "显示所有美国战列舰"

可用工具

  1. search_ships: 搜索舰船

  2. get_ship_details: 获取舰船详细信息

  3. get_ship_parameters: 获取舰船战斗参数

  4. compare_ships: 对比多艘舰船

  5. get_ships_by_nation: 按国家获取舰船

  6. get_ships_by_type: 按类型获取舰船

  7. get_ships_by_tier: 按等级获取舰船

  8. cleanup_cache: 清理缓存

支持的语言

  • en - English (默认)

  • ru - Русский

  • pl - Polski

  • de - Deutsch

  • fr - Français

  • es - Español

  • zh-cn - 简体中文

  • zh-tw - 繁體中文

  • tr - Türkçe

  • cs - Čeština

  • th - ไทย

  • vi - Tiếng Việt

  • ko - 한국어

  • ja - 日本語

支持的国家

  • usa - 美国

  • japan - 日本

  • ussr - 苏联

  • germany - 德国

  • uk - 英国

  • france - 法国

  • italy - 意大利

  • pan_asia - 泛亚

  • commonwealth - 英联邦

  • pan_america - 泛美

  • netherlands - 荷兰

  • spain - 西班牙

支持的舰船类型

  • Destroyer - 驱逐舰

  • Cruiser - 巡洋舰

  • Battleship - 战列舰

  • AirCarrier - 航空母舰

配置

环境变量

  • WARGAMING_API_KEY: Wargaming API密钥（必需）

  • DEFAULT_LANGUAGE: 默认语言（可选，默认为'en'）

  • CACHE_TTL: 缓存生存时间，秒（可选，默认3600）

  • MAX_RETRIES: 最大重试次数（可选，默认3）

  • REQUEST_TIMEOUT: 请求超时时间，秒（可选，默认30）

API配置

工具会自动处理API限制和重试逻辑：

  • 自动重试失败的请求

  • 智能缓存减少API调用

  • 请求节流避免超出限制

缓存管理

  • 自动缓存API响应

  • 可配置的缓存生存时间

  • 使用cleanup_cache工具清理过期缓存

项目结构

wows-ship-mcp/ ├── src/ │ ├── server.py # 主服务器文件 │ ├── api_client.py # API客户端 │ ├── cache.py # 缓存管理 │ ├── config.py # 配置管理 │ ├── tools.py # 工具实现 │ └── prompts.py # 提示词配置 ├── cache/ # 缓存目录 ├── requirements.txt # Python依赖 ├── pyproject.toml # 项目配置 ├── README.md # 项目说明 └── main.py # 入口文件

错误处理

工具包含完善的错误处理机制：

  • API错误: 自动重试和错误报告

  • 网络错误: 连接超时和重试逻辑

  • 数据验证: 输入参数验证

  • 缓存错误: 缓存失败时的降级处理

性能优化

  • 智能缓存: 减少重复API调用

  • 异步处理: 提高并发性能

  • 请求节流: 避免API限制

  • 数据压缩: 优化缓存存储

贡献

欢迎提交Issue和Pull Request来改进这个工具！

许可证

MIT License - 详见LICENSE文件

免责声明

本工具仅供学习和研究目的使用。使用者应当：

  1. 遵守Wargaming.net的服务条款和API使用条款

  2. 不将本工具用于任何商业目的

  3. 尊重游戏开发商的知识产权

  4. 合理使用API，避免过度请求

作者不对使用本工具可能产生的任何后果承担责任。

支持

如果您在使用过程中遇到问题，请：

  1. 查看本README的故障排除部分

  2. 检查您的API密钥和网络连接

  3. 确保遵循Wargaming开发者条款

  4. 在GitHub上提交Issue（请提供详细的错误信息）

重要提醒: 使用本工具时请始终遵循Wargaming.net的开发者条款和服务条款。

法律声明

本工具与Wargaming.net没有官方关联。《战舰世界》是Wargaming.net的注册商标。本工具仅使用公开可用的API数据，所有数据版权归Wargaming.net所有。

使用本工具即表示您：

  • 同意遵守所有相关的法律法规

  • 理解并接受使用风险

  • 承诺不将工具用于违法或违规目的

  • 同意在发现任何问题时及时停止使用

API参考

本工具使用以下Wargaming API端点：

  • /wows/encyclopedia/ships/ - 舰船百科数据

  • /wows/encyclopedia/shipprofile/ - 舰船配置文件

更多API信息请参考Wargaming API文档

更新日志

v1.0.0

  • 初始版本发布

  • 支持基本的舰船搜索和信息获取

  • 实现缓存机制

  • 添加多语言支持

  • 完善错误处理

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables users to search, compare, and retrieve detailed information about World of Warships ships using the official Wargaming.net API. Supports filtering by nation, type, and tier with multi-language support and intelligent caching.

  1. 重要声明
    1. 使用限制
      1. 数据使用声明
        1. 功能特性
          1. 安装和配置
            1. 环境变量设置
            2. Claude Desktop 配置
            3. 安全注意事项
          2. 故障排除
            1. 常见问题
          3. 可用工具
            1. 1. search_ships
            2. 2. get_ship_details
            3. 3. get_ship_parameters
            4. 4. compare_ships
            5. 5. get_ships_by_nation
            6. 6. get_ships_by_type
            7. 7. get_ships_by_tier
            8. 8. cleanup_cache
          4. 安装和使用
            1. 1. 克隆仓库
            2. 2. 安装依赖
            3. 3. 配置Claude Desktop
            4. 环境变量配置
            5. JSON配置方式
            6. 传统方式
          5. 获取API密钥
            1. 使用方法
              1. 作为MCP服务器
              2. 可用工具
            2. 支持的语言
              1. 支持的国家
                1. 支持的舰船类型
                  1. 配置
                    1. 环境变量
                    2. API配置
                    3. 缓存管理
                  2. 项目结构
                    1. 错误处理
                      1. 性能优化
                        1. 贡献
                          1. 许可证
                            1. 免责声明
                              1. 支持
                                1. 法律声明
                                  1. API参考
                                    1. 更新日志
                                      1. v1.0.0

                                    New MCP Servers

                                    MCP directory API

                                    We provide all the information about MCP servers via our MCP API.

                                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/amxkifir/wows-ship-mcp'

                                    If you have feedback or need assistance with the MCP directory API, please join our Discord server