EVE ESI Tool

MCP运维云端

提供方 Berman510

运维云端 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

一个EVE Online ESI API接口工具,提供Model Context Protocol (MCP)服务器用于AI代理集成,支持查询角色信息、资产、技能、市场数据等。

一句话选型结论

按资料字段整理

EVE ESI Tool 属于运维云端类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 34 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量34暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

EVEOnlinePython本地部署API接口AI集成游戏工具

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 34 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 34 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
EVE ESI Tool当前 34 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Berman510上游标注的维护方 Berman510
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

16.7 KB
来自项目仓库与上游目录的原文,未做删改

EVE ESI工具🚀

EVE Online ESI API接口,带有 模型上下文协议(MCP)服务器 用于AI代理集成。将您的EVE角色连接到Claude、Augment Code、Cursor或任何兼容MCP的AI助手,然后提出以下问题 “我的货舱里有什么?”, “建议一款适合单人FW的虎嘴裤”,或 “我最有价值的资产是什么?”


建筑```mermaid

graph TB
subgraph AI["AI Clients"]
A[Claude Desktop]
B[Augment Code]
C[Cursor]
D[Claude Code CLI]
end

subgraph MCP["MCP Server · mcp_server.py"]
E["34 Tools\n──────────────────\nCharacter · Skills · Assets\nWallet · Fittings · Market\nUniverse · Navigation\nHauling · Fitting Analysis\nCross-Character"]
end

subgraph LIB["eve_esi library"]
F["auth.py\nOAuth2 SSO + PKCE"]
G["client.py\nESI HTTP Client\nauto token refresh"]
H["endpoints/\nassets · characters · fittings\nfitting_analysis · hauling · market\nnavigation · skills · universe · wallet"]
end

subgraph EVE["EVE Online"]
I["ESI API\nesi.evetech.net"]
J["SSO\nlogin.eveonline.com"]
end

A & B & C & D -->|"stdio / MCP protocol"| E
E --> G
G --> H
F -->|"tokens.json"| G
G -->|"HTTPS + JWT Bearer"| I
F -->|"PKCE / Auth Code flow"| J


## OAuth2身份验证流程```mermaid
sequenceDiagram
participant U as You
participant CLI as cli.py
participant Browser as Browser
participant SSO as EVE SSO
participant ESI as ESI API

U->>CLI: python cli.py login
CLI->>Browser: Open auth URL (PKCE challenge)
Browser->>SSO: EVE login + scope approval
SSO->>CLI: Redirect → localhost:8182/callback?code=...
CLI->>SSO: POST /token (exchange code)
SSO->>CLI: access_token + refresh_token
CLI->>CLI: Store encrypted in tokens.json
Note over CLI,ESI: All future requests auto-refresh token
CLI->>ESI: GET /characters/{id}/
ESI->>CLI: Character data ✓

先决条件

  • Python 3.11+
  • EVE在线帐户
  • 已注册的EVE开发者应用程序 (免费-需要2分钟 developers.eeonline.com)

安装```bash

git clone https://github.com/yourname/eve-esi-tool
cd eve-esi-tool
pip install -e .


______________________________________________________________________

## 步骤1--注册EVE应用程序

1. 首选 developers.eeonline.com → 登录→ **应用程序→ 创建应用**
1. 集 **连接类型** → `Authentication & API Access`
1. 集 **回调URL** → `http://localhost:8182/callback`
1. 添加您想要的ESI范围(请参阅 范围参考 在......下面
1. 复制您的 **客户端ID** 并且可选 **客户端密钥**

> **PKCE vs 秘密:** 如果你忽略了 `client_secret` 从 `config.yaml`,该工具使用PKCE(对桌面应用程序更安全)。如果包含它,它将使用标准的授权码流和基本授权。

______________________________________________________________________

## 步骤2——配置```bash
cp config.example.yaml config.yaml

编辑 config.yaml:```yaml
eve_sso:
client_id: "YOUR_CLIENT_ID_HERE"
client_secret: "YOUR_SECRET_HERE" # optional — remove for PKCE-only
callback_url: "http://localhost:8182/callback"
scopes:
- "esi-skills.read_skills.v1"
- "esi-skills.read_skillqueue.v1"
- "esi-characters.read_blueprints.v1"
- "esi-assets.read_assets.v1"
- "esi-wallet.read_character_wallet.v1"
- "esi-fittings.read_fittings.v1"
- "esi-fittings.write_fittings.v1"
- "esi-markets.read_character_orders.v1"
- "esi-industry.read_character_jobs.v1"
- "esi-location.read_location.v1"
- "esi-location.read_ship_type.v1"
- "esi-clones.read_clones.v1"
- "esi-clones.read_implants.v1"
- "esi-contracts.read_character_contracts.v1"
- "esi-universe.read_structures.v1"

token_storage:
path: "tokens.json"


______________________________________________________________________

## 步骤3--登录```bash
python cli.py login

EVE SSO的浏览器窗口打开。批准后,您的令牌将保存到 tokens.json. 每个字符运行一次。 您可以对多个字符进行身份验证——所有工具都接受一个可选字符 character_id 参数。


CLI 参考```bash

python cli.py login # Authenticate a character via EVE SSO
python cli.py chars # List all authenticated characters
python cli.py info # Show character info (corp, alliance, etc.)
python cli.py skills # Show skill summary (total SP, top skills)
python cli.py wallet # Show ISK wallet balance
python cli.py queue # Show skill training queue


______________________________________________________________________

## 步骤4——连接到您的AI工具

MCP服务器使用 **stdio传输** --AI客户端将其作为子进程启动,并通过stdin/stdout进行通信。

### 增强码(VS码)

打开VS Code用户设置(Ctrl+Shift+P→ **“首选项:打开用户设置(JSON)”**)并添加:```json
{
"augment.advanced": {
"mcpServers": {
"eve-esi": {
"command": "python",
"args": ["C:/path/to/eve-esi-tool/mcp_server.py"],
"cwd": "C:/path/to/eve-esi-tool"
}
}
}
}

然后重新加载VS代码(Ctrl+Shift+P→ “开发人员:重新加载窗口”).EVE ESI工具将在代理模式下自动可用。

> Windows提示: 使用正斜杠 / 或双反睫毛 \\ 在路上。


克劳德桌面

编辑 %APPDATA%\Claude\claude_desktop_config.json 在Windows上,或 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上。如果文件不存在,请创建该文件:```json
{
"mcpServers": {
"eve-esi": {
"command": "python",
"args": ["/path/to/eve-esi-tool/mcp_server.py"],
"cwd": "/path/to/eve-esi-tool"
}
}
}


重新启动克劳德桌面。你会看到一个 **🔨 锤图标** 加载MCP工具时,在聊天输入栏中。单击它以查看所有可用工具。

> **启用开发人员模式:** 在克劳德桌面→ 设置→ 开发者→ 启用开发人员模式以查看操作系统的配置文件路径。

______________________________________________________________________

### 光标

添加 `.cursor/mcp.json` 在项目根目录中,或 `~/.cursor/mcp.json` 全球地:```json
{
"mcpServers": {
"eve-esi": {
"command": "python",
"args": ["/path/to/eve-esi-tool/mcp_server.py"],
"cwd": "/path/to/eve-esi-tool"
}
}
}

启用MCP 光标设置→ 特性→ MCP → 启用MCP.


克劳德代码(CLI)```bash

Add the server

claude mcp add eve-esi python /path/to/eve-esi-tool/mcp_server.py

Or add with working directory

claude mcp add eve-esi --cwd /path/to/eve-esi-tool python mcp_server.py

Verify it's registered

claude mcp list


______________________________________________________________________

## 可用的MCP工具```mermaid
mindmap
root((EVE ESI\nMCP Tools))
Character
list_authenticated_characters
set_active_character
get_character_info
get_character_location
get_character_ship
get_character_status
Skills
get_skills_summary
get_skill_queue
get_character_attributes
get_active_implants
Assets
get_assets_list
search_assets
get_assets_summary
Wallet
get_wallet_balance
get_wallet_journal
Fittings
get_ship_fittings
save_ship_fitting
Market
get_market_orders
check_item_price
get_blueprints_list
get_industry_jobs_list
Universe
lookup_item_type
search_item_type
lookup_solar_system
resolve_eve_names
Navigation
plan_route
Hauling
find_valuables_to_haul
Fitting Analysis
get_ship_fit_stats
compare_ship_fits
get_fit_required_skills
check_fit_readiness
Cross-Character
get_all_characters_status
compare_skills_across_characters
compare_wallets

角色和地位

工具 说明
list_authenticated_characters 列出所有带有位置、船只、钱包和活动状态的字符
set_active_character 设置何时默认使用哪些字符工具 character_id 省略
get_character_info 姓名、公司、联盟、生日、安全状态
get_character_location 当前的太阳系
get_character_ship 目前正在飞行的船只
get_character_status 一个通话快照:位置+船+钱包余额

技能

工具 说明
get_skills_summary 总SP、未分配SP、所有已培训技能
get_skill_queue 排队技能与完成时间
get_character_attributes Int/Mem/Per/Wil/Cha+重映射可用性
get_active_implants 当前插入的植入物

资产和钱包

工具 说明
get_assets_list 所有自有物品及其位置/数量
search_assets 按项目类型名称搜索资产
get_assets_summary 按ISK值按站点分组的资产
get_wallet_balance ISK余额
get_wallet_journal 最近的钱包交易

配件与市场

工具 说明
get_ship_fittings 游戏中所有保存的配件
save_ship_fitting 将新配件保存到游戏中✍️
get_market_orders 角色的主动卖出/买入订单
check_item_price 任何地区的最佳买入/卖出价格(默认值:Jita)
get_blueprints_list 所有带有ME/TE/运行信息的蓝图
get_industry_jobs_list 活跃/已完成的制造和研究工作

宇宙与导航

工具 说明
lookup_item_type 任何项目ID的完整类型信息+教条属性
search_item_type 按名称查找项目ID
lookup_solar_system 系统信息(安全、行星、星际之门)
resolve_eve_names 转换任何EVE ID→ 姓名
plan_route 具有最近邻优化的多系统路线规划器

运输

工具 说明
find_valuables_to_haul 扫描资产中的小/贵重物品,计划取件路线并定价

拟合分析

工具 说明
get_ship_fit_stats 解析EFT贴合度→ 完整统计数据(防御、装备、导航、盖帽、采矿、货物)
compare_ship_fits 两个EFT的并排比较与delta拟合
get_fit_required_skills 提取飞行给定EFT所需的所有技能
check_fit_readiness 检查哪些角色可以飞得很好,他们缺少哪些技能

交叉字符

工具 说明
get_all_characters_status 所有经过身份验证的角色的位置、船只和钱包
compare_skills_across_characters 比较所有角色的特定技能(或总SP)
compare_wallets 所有钱包余额+账户间总ISK

> ✍️ save_ship_fitting 是唯一的工具 写 到您的帐户。所有其他都是只读的。


对话示例

连接后,您可以问自然语言问题:```
"What ship is my character flying and where are they?"
"Show me my top 10 most valuable assets"
"What skills am I training and when does the queue finish?"
"Check the Jita price for a Raven Navy Issue"
"Do I have any active industry jobs?"
"What are my saved fittings for a Rifter?"
"Suggest a solo PvP fit for my Caldari Navy Hookbill based on my skills"
"How much would I make if I sold all my blueprints in Jita?"
"Compare my Covetor fit to a Hulk fit — which is better for moon mining?"
"What skills do I need to fly this Hulk fit?" (paste EFT)
"Which of my characters can fly this fit and what are they missing?"
"Give me a status update on all my characters"
"Compare Mining Barge and Astrogeology skills across all my alts"
"Find all my valuable items scattered around and plan a pickup route back to Jita"


______________________________________________________________________

## 多字符支持

您可以验证多个EVE字符。跑 `python cli.py login` 每个字符一次--所有令牌都存储在 `tokens.json`.```bash
# Log in additional characters (run once per character)
python cli.py login

# List all authenticated characters
python cli.py chars

活跃的性格

使用 set_active_character 选择何时默认使用哪些字符工具 character_id 省略。如果没有设置活动字符,则使用第一个经过身份验证的字符。

所有单独的工具也接受可选 character_id 用于特定alt上的ad-hoc查询的参数。

跨角色工具

这些工具操作 全部 一次验证字符——无需逐一查询:

  • get_all_characters_status --在一次通话中为每个人提供位置、船只和钱包
  • compare_skills_across_characters --并排比较特定技能或总SP
  • compare_wallets --所有钱包余额+车队总ISK
  • check_fit_readiness --检查哪些角色可以飞出给定的适合度,以及它们缺少什么

项目结构```

eve-esi-tool/
├── mcp_server.py # MCP server — 34 tools for AI agents
├── cli.py # Command-line interface
├── config.example.yaml # Config template
├── config.yaml # Your config (not committed)
├── tokens.json # OAuth tokens (not committed)
├── scripts/ # Temporary/ad-hoc scripts (auto-cleaned)
├── eve_esi/
│ ├── auth.py # OAuth2 SSO + PKCE flow + token storage
│ ├── client.py # ESI HTTP client with auto token refresh
│ ├── config.py # Config loading (YAML)
│ └── endpoints/
│ ├── assets.py # Character assets
│ ├── characters.py # Character info, location, ship
│ ├── fitting_analysis.py # EFT parsing, stats, comparison, skill requirements
│ ├── fittings.py # Ship fittings CRUD
│ ├── hauling.py # Asset analysis & pickup-run planner
│ ├── market.py # Orders, prices, blueprints, industry
│ ├── navigation.py # Route planning & multi-stop optimization
│ ├── skills.py # Skills, queue, attributes, implants
│ ├── universe.py # Type info, system info, name resolution
│ └── wallet.py # Wallet balance and journal
└── CLAUDE.md # Agent instructions (Claude Code / Cursor)


______________________________________________________________________

## 范围参考

|作用域|启用|
|---|---|
| `esi-skills.read_skills.v1` | `get_skills_summary`, `compare_skills_across_characters`, `check_fit_readiness` |
| `esi-skills.read_skillqueue.v1` | `get_skill_queue`, `get_character_attributes` |
| `esi-clones.read_implants.v1` | `get_active_implants` |
| `esi-assets.read_assets.v1` | `get_assets_list`, `search_assets`, `get_assets_summary`, `find_valuables_to_haul` |
| `esi-wallet.read_character_wallet.v1` | `get_wallet_balance`, `get_wallet_journal`, `compare_wallets` |
| `esi-fittings.read_fittings.v1` | `get_ship_fittings` |
| `esi-fittings.write_fittings.v1` | `save_ship_fitting` |
| `esi-markets.read_character_orders.v1` | `get_market_orders` |
| `esi-characters.read_blueprints.v1` | `get_blueprints_list` |
| `esi-industry.read_character_jobs.v1` | `get_industry_jobs_list` |
| `esi-location.read_location.v1` | `get_character_location`, `get_character_status`, `get_all_characters_status` |
| `esi-location.read_ship_type.v1` | `get_character_ship`, `get_character_status`, `get_all_characters_status` |
| `esi-contracts.read_character_contracts.v1` |未来:合同工具|
| `esi-universe.read_structures.v1` |玩家结构中的资产位置|

> **注:** 拟合分析工具(`get_ship_fit_stats`, `compare_ship_fits`, `get_fit_required_skills`)以及宇宙/导航工具(`plan_route`, `lookup_item_type`等)使用 **公共ESI端点** 并且不需要任何范围。

______________________________________________________________________

## 安全说明

- `tokens.json` 和 `config.yaml` 通过git排除在外 `.gitignore`
- 令牌存储在本地,从不发送给任何第三方
- MCP服务器仅在您的AI客户端处于活动状态时运行
- 所有ESI呼叫直接转到 `esi.evetech.net` 通过HTTPS
- 唯一的写入操作是 `save_ship_fitting` --不能移动任何ISK或项目

______________________________________________________________________

## 故障排除

**`No authenticated characters` 错误**```bash
python cli.py login   # run this first

400 Bad Request 登录期间

  • 确保你的 callback_url 在 config.yaml 与您在EVE开发者门户中设置的完全匹配

MCP工具未在Augment/Claude中显示

  • 检查一下 command 路径指向正确的Python可执行文件
  • 确保你已经跑过了 pip install -e . 在项目目录中
  • 编辑配置后重新加载VS代码/重新启动Claude Desktop

特定工具上的范围错误

  • 重新运行 python cli.py login 在添加新作用域后 config.yaml
  • 确保新的作用域也添加到您的EVE开发人员应用程序中

内置于 FastMCP ·ESI数据来自 EVE在线ESI

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
EVE ESI Tool 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

EVE ESI Tool 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

EVE ESI Tool 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

EVE ESI Tool 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

EVE ESI Tool 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

EVE ESI Tool 能提供哪些能力?

资料显示约 34 个工具;能力标签包括 Python、Claude、API接口。具体工具清单以官方文档为准。

EVE ESI Tool 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

EVE ESI Tool 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。