EVE大学Wiki MCP服务器
Docker化的MCP服务器为Claude提供了对EVE大学维基的实时访问。针对Raspberry Pi和家庭实验室进行了优化，具有自动化的多架构构建。
这有什么作用
为克劳德提供来自社区维护的EVE大学维基的最新EVE在线信息。当你询问船只、机械师或导游时，克劳德可以获取最新信息，而不是依赖过时的训练数据。
可用工具：
- search_eve_wiki -搜索有关船舶、机械、指南的文章
- get_eve_wiki_page -在Markdown中获取整页内容
- get_eve_wiki\\summary -获取简短的页面介绍
- browse_eve_wiki_类别 -按类别浏览页面（船舶、采矿、PvP等）
- 获取页面 -查找链接到特定页面的页面
- generate_newbro_mining_plan -为全新的Alpha玩家制定保守的仅限挖矿的入职计划
快速开始
Raspberry Pi部署（推荐）
# Clone the repository
git clone https://github.com/tommybobb/eve-wiki-mcp.git
cd eve-wiki-mcp
# Run one-click deployment
chmod +x deploy-pi.sh
./deploy-pi.sh脚本将自动执行以下操作：
- ✅ 如果需要，安装Docker
- ✅ 在本地构建容器
- ✅ 启动服务
- ✅ 显示Claude Desktop的配置
使用预构建图像（最快）
# Clone for configuration files
git clone https://github.com/tommybobb/eve-wiki-mcp.git
cd eve-wiki-mcp
# Copy environment template
cp .env.example .env
# Pull pre-built multi-arch image from GHCR
docker pull ghcr.io/tommybobb/eve-wiki-mcp:latest
# Start with pre-built image
docker-compose -f docker-compose.ghcr.yml up -d
# Check health
curl http://localhost:8000/healthDocker编写手册
git clone https://github.com/tommybobb/eve-wiki-mcp.git
cd eve-wiki-mcp
cp .env.example .env
docker-compose up -dClaude桌面配置
将此添加到您的Claude Desktop配置文件中：
配置文件位置：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - 雨衣：
~/Library/Application Support/Claude/claude_desktop_config.json
配置（使用mcp-remote）：
{
"mcpServers": {
"eve-wiki": {
"command": "npx",
"args": ["mcp-remote", "http://YOUR_IP:8000/sse", "--allow-http", "--transport", "sse-only"]
}
}
}注： 这需要在您的系统上安装Node.js。这 mcp-remote 该包将Claude Desktop桥接到远程SSE服务器。替换 YOUR_IP 与：
- 您的Raspberry Pi的IP地址（例如。，
192.168.1.100) localhost如果在同一台机器上运行- 您的服务器主机名
重新启动克劳德桌面 添加配置后完全完成。
推荐系统提示
让克劳德 自动地 当您询问EVE Online时，请使用wiki工具（而不是要求您明确请求），将其添加到您的Claude Desktop自定义说明中 设置>自定义说明:
当我询问EVE Online时——船只、配件、模块、技能、游戏机制、探索、PvP、PvE、工业、采矿、虫洞、空秒、主权、舰队行动或任何其他游戏主题——在回答之前，请务必使用EVE大学维基MCP工具查找准确、最新的信息。先搜索维基，然后获取相关页面以获取详细信息。不要仅仅依赖训练数据来获取EVE特定的信息，因为游戏机制和飞船统计数据会随着补丁而频繁变化。
配置
环境变量
这 .env 文件控制服务器行为。从模板复制：
cp .env.example .env可用设置：
MCP_TRANSPORT=sse # Keep as 'sse' for Docker deployment
MCP_HOST=0.0.0.0 # Listen on all network interfaces
MCP_PORT=8000 # Server port资源限制
针对Raspberry Pi优化的默认限制：
- 中央处理器：最多一个核心的50%，预留25%
- 记忆：最大256MB，保留128MB
调整 如果需要的话。
使用示例
连接后，问克劳德：
船舶信息：
- “德雷克有什么好处？”
- “比较Caldari和Gallente护卫舰”
- “最适合初学者的探险船？”
游戏机制：
- “虫洞产卵是如何运作的？”
- “解释装配窗口”
- “什么是深海死区？”
指南：
- 《初学者挖矿指南》
- “PvP基础”
- “如何让ISK成为新玩家？”
采矿副驾驶（纽布罗）：
- “为一个全新的Alpha生成一个仅限挖矿的第1天和第1周计划，包括1.5小时的会话、4个会话/周和0个起始ISK。”
- “更新我的采矿计划：上一次我被困住了，失去了我的船。”
- “用这个问题来完善我的挖矿计划：如果我只有50万冰岛克朗，我应该先买什么？”
示例使用循环：
- 询问您的初始采矿计划，包括时间预算+开始ISK。
- 玩一个会话，并记录发生了什么（损失、获得的ISK、阻断者）。
- 粘贴
recent_outcome并重新运行generate_newbro_mining_plan. - 重复每个环节，以保持计划的适应性和保守性。
管理命令
使用Makefile（推荐）
make help # Show all available commands
make up # Start service
make down # Stop service
make logs # View logs
make restart # Restart service
make health # Check health status
make stats # Show resource usage
make rebuild # Rebuild and restart
make pull-ghcr # Pull pre-built image from GHCR
make update-from-git # Update from git and rebuild使用Docker Compose
docker-compose up -d # Start
docker-compose down # Stop
docker-compose logs -f # View logs
docker-compose restart # Restart
docker-compose ps # Check status
docker stats eve-wiki-mcp # Monitor resources更新中
来自Git（本地构建）
cd eve-wiki-mcp
git pull origin main
make rebuild使用预构建图像
docker pull ghcr.io/tommybobb/eve-wiki-mcp:latest
docker-compose -f docker-compose.ghcr.yml restart持续集成
此项目使用 GitHub操作 对于自动化构建：
- ✅ 多架构Docker镜像（amd64/arm64）
- ✅ 发布到GitHub容器注册表（GHCR）
- ✅ 自动构建到主分支
- ✅ 标记为稳定版本的发布
预构建图像可在以下网址获得：
ghcr.io/tommybobb/eve-wiki-mcp:latest生成状态
多拱形图像是自动构建的，用于：
linux/amd64-Intel/AMD系统linux/arm64-Raspberry Pi 3/4/5，ARM服务器
资源使用情况
树莓派4（4GB）：
- 闲置：2-5%的CPU，80-100MB的RAM
- 活跃的：20%-30%的CPU，120-150MB的RAM
- 网络：最小（仅在wiki获取期间）
非常适合在Raspberry Pi上全天候运行！
家庭实验室集成
Proxmox LXC容器
- 创建Ubuntu 22.04 LXC容器
- 安装Docker：
curl -fsSL https://get.docker.com | sh - 克隆和部署：
./deploy-pi.sh
使用现有监控
InfluxDB + 图表：
- 将容器指标添加到现有堆栈中
- 监视wiki API延迟
- 跟踪请求计数
Telegraf配置示例：
[[inputs.docker]]
endpoint = "unix:///var/run/docker.sock"
container_names = ["eve-wiki-mcp"]反向代理（Nginx/Traefik）
为了实现安全的外部访问：
Nginx：
location /eve-mcp/ {
proxy_pass http://localhost:8000/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
}Traefik标签：
labels:
- "traefik.enable=true"
- "traefik.http.routers.eve-mcp.rule=Host(`eve-mcp.local`)"
- "traefik.http.services.eve-mcp.loadbalancer.server.port=8000"故障排除
容器无法启动
# Check logs
docker-compose logs
# Check if port is in use
sudo netstat -tlnp | grep 8000
# Try manual run for debugging
docker run -it --rm -p 8000:8000 -e MCP_TRANSPORT=sse eve-wiki-mcp无法从Claude连接
- 验证服务是否正在运行：
curl http://localhost:8000/health- 从桌面检查：
curl http://PI_IP:8000/health- 打开防火墙端口：
sudo ufw allow 8000/tcp- 验证Claude配置：
- URL必须是 http:// （不是 https://) - 必须包括 /sse 路径 - IP必须可以从桌面访问
Wiki超时
维基可能很慢。如果您看到超时：
- 检查您的互联网连接
- 增加超时时间 （更改
TIMEOUT = 30.0到60.0) - 重建：
make rebuild
安全
此服务器包括多个安全功能，用于安全部署：
内置安全功能
- ✅ 输入验证 -所有用户输入的类型、长度和内容都经过验证
- ✅ 速率限制 -可配置每个客户端的速率限制（默认值：60 req/min）
- ✅ 可选身份验证 -承载令牌身份验证支持
- ✅ 安全错误处理 -山宁泰错误，仅在服务器端进行详细日志记录
- ✅ URL译码 -正确的编码可防止注射攻击
- ✅ 非根容器 -以无特权用户身份运行（UID 1000）
- ✅ 固定依赖关系 -可重复、安全构建的精确版本
安全配置
启用身份验证 （建议外部访问）：
# In .env file
MCP_AUTH_TOKEN=your-secure-random-token-here
# Generate a secure token:
openssl rand -hex 32配置速率限制:
RATE_LIMIT_REQUESTS=60 # requests per window
RATE_LIMIT_WINDOW=60 # seconds启用CORS （适用于web客户端）：
CORS_ORIGINS=https://example.com,https://app.example.com部署建议
- 仅限本地网络 默认情况下（0.0.0.0绑定允许LAN访问）
- 启用身份验证 如果暴露在外
- 使用反向代理 用于TLS/HTTPS的（Nginx/Traefik）
- 建议使用防火墙 限制对受信任网络的访问
- 首选VPN 用于外部访问，而不是直接接触互联网
看 安全.md 获取完整的安全文档和最佳实践
项目结构
eve-wiki-mcp/
├── eve_wiki_mcp_server_docker.py # Main MCP server implementation
├── Dockerfile # Multi-arch container image
├── docker-compose.yml # Local build service config
├── docker-compose.ghcr.yml # Pre-built image service config
├── requirements.txt # Python dependencies
├── .env.example # Configuration template
├── .dockerignore # Docker build exclusions
├── Makefile # Management commands
├── deploy-pi.sh # Raspberry Pi deployment script
├── README.md # This file
├── README_DOCKER.md # Detailed Docker documentation
├── DOCKER_DEPLOYMENT.md # Comprehensive deployment guide
├── SECURITY.md # Security documentation and best practices
├── LICENSE # MIT license
├── CONTRIBUTING.md # Contribution guidelines
├── CHANGELOG.md # Version history
└── .github/
└── workflows/
└── docker-build.yml # CI/CD pipeline文档
发展
构建多建筑图像
GitHub Actions工作流会自动处理此问题，但您可以在本地构建：
# Setup buildx (one time)
docker buildx create --name multiarch --use
# Build for multiple platforms
docker buildx build \
--platform linux/amd64,linux/arm64 \
-t eve-wiki-mcp:latest \
.本地测试
# Run in development mode
docker-compose up
# Watch logs
docker-compose logs -f
# Test health endpoint
curl http://localhost:8000/health
# Test SSE connection
curl -N http://localhost:8000/ssePython单元测试（pytest）
# Install test runner (if not already installed)
pip install pytest
# Run unit tests for mining copilot tool
python -m pytest -q贡献
欢迎改进！感兴趣的领域：
- 性能优化
- 其他wiki功能
- 更好的错误处理
- 更全面的文档
- 缓存层（Redis）
- 速率限制
- 度量/监控（普罗米修斯）
看 贡献.md 作为指导方针。
许可证
服务器代码： MIT许可证-请参阅 许可证
EVE大学维基内容： CC BY SA 4.0
EVE在线： ©CCP Games-所有与EVE相关的材料均为CCP Games的财产
学分
- EVE大学 -惊人的wiki和社区资源
- CCP游戏 -EVE在线
- Anthropic -MCP协议与Claude
- 社区 -所有贡献者和用户
支持
- 问题： 报告错误并请求功能
- 讨论： 加入对话
- EVE大学： 访问 wiki.eveuniversity.org EVE在线内容
______________________________________________________________________
准备好飞翔了吗？ 克隆仓库，运行 ./deploy-pi.sh，问克劳德关于EVE的事！o7
由...制作❤️ EVE Online和家庭实验室社区。