E
eSimfly-Official/esimfly-mcp
Give your AI assistant hands on the eSIMfly Business API.
更新 2026-11-18
在 GitHub 查看 ↗直链 · 无中转页
安装与配置
远端端点(Claude Desktop / Cursor / Windsurf 共用 mcpServers)
{
"mcpServers": {
"esimfly-official-esimfly-mcp": {
"url": "https://mcp.esimfly.net/mcp"
}
}
}把这段粘进 Claude Desktop / Cursor 的 mcpServers 配置即可。端点来自公开证据,我们没有替你安装或托管它。 官方 Registry 记录:这个端点没有列出任何请求头。这不等于免密 —— 以项目文档为准。
VS Code(.vscode/mcp.json —— 键名是 servers,远程要 type: http)
{
"servers": {
"esimfly-official-esimfly-mcp": {
"type": "http",
"url": "https://mcp.esimfly.net/mcp"
}
}
}VS Code 的配置文件和另外三家不同:顶层键是 <code>servers</code>,远程端点还要写 <code>"type": "http"</code>。复制到 .vscode/mcp.json。
Claude Code(命令行)
claude mcp add --transport http esimfly-official-esimfly-mcp https://mcp.esimfly.net/mcp
Claude Code 不收 JSON 文件,用这条命令直接加。
配置文件在:macOS
~/Library/Application Support/Claude/claude_desktop_config.json、Windows %APPDATA%\Claude\claude_desktop_config.json、Linux ~/.config/Claude/claude_desktop_config.json。配置项的键名以你的客户端为准:客户端与 CLI- ★ 数取值
- 0 ★ · eSimfly-Official/esimfly-mcp · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
怎么安装?
我们【没有】从该仓库取到安装命令(我们的 install 覆盖率只有约 4%)。请看它的 README 或 releases 页。
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
eSimfly-Official/esimfly-mcp;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# @esimfly/mcp — eSIMfly MCP server
以下摘录自该仓库的 README(片段)
Give your AI assistant hands on the eSIMfly Business API. With this
Model Context Protocol server, Claude, Cursor, ChatGPT and other
MCP clients can search eSIM plans with your wholesale prices, check balances and usage, diagnose
"no data" problems from live network data — and, if you enable it, place orders and top-ups with an
explicit confirmation step.
Read-only by default. Nothing can spend your balance unless you opt in.
Two-step writes. Every write tool returns a preview (what, cost, balance) until called with confirm: true.
Built on the official @esimfly/sdk — signing, retries and error codes handled.
Ships two prompts: the complete integration guide and an eSIM diagnosis workflow.
Docs: https://docs.esimfly.net · Credentials: Business Dashboard → Settings → API Keys.
## Hosted server (no install)
Prefer not to run anything locally? eSIMfly hosts this same server at https://mcp.esimfly.net/mcp.
Add it as a remote MCP server in Claude.ai, ChatGPT, Claude Code (claude mcp add --transport http esimfly https://mcp.esimfly.net/mcp),
Cursor or VS Code and sign in with your eSIMfly business account — OAuth 2.1, no keys to paste, write
tools opt-in on the consent screen. Details: https://docs.esimfly.net/docs/mcp-server
## Local install
The server runs locally over stdio; your API key never leaves your machine.
### Claude Desktop
claude_desktop_config.json → mcpServers:
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": {
"ESIMFLY_ACCESS_CODE": "esf_...",
"ESIMFLY_SECRET_KEY": "sk_..."
### Claude Code
bash
claude mcp add esimfly -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... -- npx -y @esimfly/mcp
### Cursor / Windsurf / other MCP clients
.cursor/mcp.json (or the client's equivalent):
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": { "ESIMFLY_ACCESS_CODE": "esf_...", "ESIMFLY_SECRET_KEY": "sk_..." }
### Docker
bash
docker build -t esimfly-mcp .
docker run -i --rm -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... esimfly-mcp
### Enable write tools
Add "ESIMFLY_MCP_ALLOW_WRITES": "true" to env. Without it the ordering, top-up, cancel,
suspend, SMS and webhook tools are not even registered.
## Try it
"Find the cheapest 5 GB plan for Turkey and tell me my margin at €9.99."
"Which of my eSIMs are active and below 200 MB?"
"ICCID 8948010010036785060 says no data — diagnose it." (uses the diagnose_esim prompt)
"Set up webhooks for installed / status / low-data events at https://my.app/hooks." (write tool, previews first)
"Build me a Node.js integration." (uses the esimfly_integration_guide prompt)
## Tools
| Tool | What it does | Mode |
| search_packages | Catalogue search by destination / type with your cost price | read |
| get_balance | Account (or enterprise) balance | read |
| list_esims | Your eSIMs with status, data left, validity | read |
| get_esim_usage | Stored usage for one eSIM (cheap) | read |
| get_esim_live_status | Live status from the network: install state, last network, device, usage | read (expensive) |
| get_network_events | Last 7 days of attach / data-session events, wrong-network flag | read |
Model Context Protocol server, Claude, Cursor, ChatGPT and other
MCP clients can search eSIM plans with your wholesale prices, check balances and usage, diagnose
"no data" problems from live network data — and, if you enable it, place orders and top-ups with an
explicit confirmation step.
Read-only by default. Nothing can spend your balance unless you opt in.
Two-step writes. Every write tool returns a preview (what, cost, balance) until called with confirm: true.
Built on the official @esimfly/sdk — signing, retries and error codes handled.
Ships two prompts: the complete integration guide and an eSIM diagnosis workflow.
Docs: https://docs.esimfly.net · Credentials: Business Dashboard → Settings → API Keys.
## Hosted server (no install)
Prefer not to run anything locally? eSIMfly hosts this same server at https://mcp.esimfly.net/mcp.
Add it as a remote MCP server in Claude.ai, ChatGPT, Claude Code (claude mcp add --transport http esimfly https://mcp.esimfly.net/mcp),
Cursor or VS Code and sign in with your eSIMfly business account — OAuth 2.1, no keys to paste, write
tools opt-in on the consent screen. Details: https://docs.esimfly.net/docs/mcp-server
## Local install
The server runs locally over stdio; your API key never leaves your machine.
### Claude Desktop
claude_desktop_config.json → mcpServers:
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": {
"ESIMFLY_ACCESS_CODE": "esf_...",
"ESIMFLY_SECRET_KEY": "sk_..."
### Claude Code
bash
claude mcp add esimfly -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... -- npx -y @esimfly/mcp
### Cursor / Windsurf / other MCP clients
.cursor/mcp.json (or the client's equivalent):
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": { "ESIMFLY_ACCESS_CODE": "esf_...", "ESIMFLY_SECRET_KEY": "sk_..." }
### Docker
bash
docker build -t esimfly-mcp .
docker run -i --rm -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... esimfly-mcp
### Enable write tools
Add "ESIMFLY_MCP_ALLOW_WRITES": "true" to env. Without it the ordering, top-up, cancel,
suspend, SMS and webhook tools are not even registered.
## Try it
"Find the cheapest 5 GB plan for Turkey and tell me my margin at €9.99."
"Which of my eSIMs are active and below 200 MB?"
"ICCID 8948010010036785060 says no data — diagnose it." (uses the diagnose_esim prompt)
"Set up webhooks for installed / status / low-data events at https://my.app/hooks." (write tool, previews first)
"Build me a Node.js integration." (uses the esimfly_integration_guide prompt)
## Tools
| Tool | What it does | Mode |
| search_packages | Catalogue search by destination / type with your cost price | read |
| get_balance | Account (or enterprise) balance | read |
| list_esims | Your eSIMs with status, data left, validity | read |
| get_esim_usage | Stored usage for one eSIM (cheap) | read |
| get_esim_live_status | Live status from the network: install state, last network, device, usage | read (expensive) |
| get_network_events | Last 7 days of attach / data-session events, wrong-network flag | read |
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/esimfly-official-esimfly-mcp/)
- 来源
- awesome · https://github.com/eSimfly-Official/esimfly-mcp
- 按领域浏览
- MCP 服务
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。