wowarmorymcp (Douganredhammer)

WoW军械库MCP服务器

一个模型上下文协议（MCP）服务器，提供对魔兽世界军械库数据和功能的访问。

概述

此MCP服务器使AI助手能够通过暴雪的Armory网站与魔兽世界角色信息进行交互，提供角色查找和声誉跟踪工具。

先决条件

• Python 3.8或更高版本
• 紫外线 包管理器
• Git

安装

1. 克隆存储库：

   git clone 
   cd wow-armory-mcp

1. 设置虚拟环境：

   uv venv

1. 安装依赖项：

   uv pip install -r pyproject.toml

注： 该命令从以下位置安装依赖项 pyproject.toml 而不是传统 requirements.txt 文件。

配置

Claude桌面集成

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

配置文件的位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "wow-armory": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/wow-armory-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

重要提示： 替换 /path/to/your/wow-armory-mcp 使用克隆存储库的实际绝对路径。

环境变量

如果您的服务器需要API凭据或配置，请创建 .env 项目根目录中的文件：

# Add any required environment variables here
# Example:
# WOW_API_KEY=your_api_key_here

用法

配置后，重新启动Claude Desktop。当克劳德需要访问魔兽世界相关信息时，魔兽世界军械库服务器将自动启动。

可用工具

服务器提供与魔兽世界军械库数据交互的工具：

• 字符信息 -获取详细的角色信息，包括级别、职业、种族和装备
• 角色声誉 -检索不同派系的角色声誉排名

发展

手动运行服务器

对于开发和测试：

# Activate the virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Run the server
python server.py

项目结构

wow-armory-mcp/
├── server.py          # Main MCP server implementation
├── pyproject.toml      # Project dependencies and metadata
├── .env               # Environment variables (create this)
├── README.md          # This file
└── src/               # Source code directory
    ├── __init__.py
    ├── armory/        # Armory API client
    ├── tools/         # MCP tool implementations
    └── utils/         # Utility functions

故障排除

常见问题

1. “找不到命令：uv”

- 按照以下步骤安装uv 官方文件

1. “权限被拒绝”错误

- 确保Claude Desktop配置中的路径使用正斜杠，即使在Windows上也是如此 - 验证绝对路径是否正确

1. API身份验证失败

- 验证是否正确配置了任何必需的API凭据 - 检查你的 .env 文件（如果需要身份验证）

1. 服务器无法启动

- 验证是否安装了所有依赖项： uv pip list - 检查服务器日志中的特定错误消息

调试

通过设置环境变量启用调试日志记录：

export MCP_LOG_LEVEL=debug

贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature-name
3. 进行更改并添加测试
4. 提交您的更改： git commit -am 'Add some feature'
5. 推到分支： git push origin feature-name
6. 提交拉取请求

许可证

MIT许可证

版权所有（c）2025丹尼尔·富兰克林

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

支持

对于问题和疑问：

• 在GitHub上打开一个问题
• 检查 MCP文件
• 查看暴雪军械库网站文档

更新日志

\[1.0.0-beta\]-2025年8月27日

• 初始版本
• 基本角色和公会查找功能
• 与Claude Desktop集成