Magicline MCP

MCP开发工具

提供方 LucaGerlich

开发工具 未标注 API Key 社区 / 第三方 Claude DesktopClaude

Magicline API服务器为MCP兼容客户端提供Magicline API(OpenAPI、Connect API、Device API、Webhooks API)的访问接口。

一句话选型结论

按资料字段整理

Magicline MCP 属于开发工具类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

支持客户端

适用场景

API接口TypeScript本地部署MCP兼容Magicline集成OpenAPIWebhooks

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Magicline MCP当前 6 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方LucaGerlich上游标注的维护方 LucaGerlich
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

magicline mcp服务器

用于Magigline API(OpenAPI、Connect API、Device API、Webhook)的MCP服务器。
服务器加载官方的OpenAPI规范,并将每个操作注册为MCP工具。

概述

此服务器通过stdio向MCP兼容客户端公开Magicline端点。
官方OpenAPI规范中的每个操作都成为一个具有稳定、命名空间名称的工具。

包含的API:

  • OpenAPI(核心Magigline API)
  • 连接API
  • 设备API
  • Webhooks API

工具前缀:

  • magicline_ (OpenAPI)
  • magicline_connect_ (连接API)
  • magicline_device_ (设备API)
  • magicline_webhooks_ (Webhooks)

通用回退工具:

  • magicline_request (JSON或原始正文)
  • magicline_request_multipart (多部分/表单数据)

需求

  • Node.js 18+(使用内置 fetch)
  • Magicline凭据和基本URL

快速开始

  1. 安装依赖项:```bash
    npm install

2. 获取最新规格(可选但推荐):```bash
npm run update-openapi
  1. 构建:```bash
    npm run build

4. 运行(stdio传输):```bash
MAGICLINE_BASE_URL="https://..." \
MAGICLINE_API_KEY="..." \
node build/index.js

环境变量

OpenAPI(必填)

  • MAGICLINE_BASE_URL
  • MAGICLINE_API_KEY
  • MAGICLINE_API_KEY_HEADER (可选,默认 X-API-KEY)

连接API(可选)

  • MAGICLINE_CONNECT_BASE_URL
  • MAGICLINE_CONNECT_API_KEY (可选)
  • MAGICLINE_CONNECT_API_KEY_HEADER (可选,默认 X-API-KEY)

设备API(可选,承载令牌)

  • MAGICLINE_DEVICE_BASE_URL
  • MAGICLINE_DEVICE_API_TOKEN
  • MAGICLINE_DEVICE_AUTH_HEADER (可选,默认 Authorization)
  • MAGICLINE_DEVICE_AUTH_PREFIX (可选,默认 Bearer)

Webhooks API(可选)

  • MAGICLINE_WEBHOOKS_BASE_URL
  • MAGICLINE_WEBHOOKS_API_KEY
  • MAGICLINE_WEBHOOKS_API_KEY_HEADER (可选,默认 X-API-KEY)

规格覆盖(高级)

您可以覆盖更新脚本和运行时加载器使用的规范URL:

  • MAGICLINE_OPENAPI_URL
  • MAGICLINE_CONNECT_OPENAPI_URL
  • MAGICLINE_DEVICE_OPENAPI_URL
  • MAGICLINE_WEBHOOKS_OPENAPI_URL

工具是如何生成的

所有工具均源自OpenAPI规范:

  • src/openapi.json
  • src/connectapi.json
  • src/deviceapi.json
  • src/webhooks.json

启动时,服务器加载这些规范(如果本地文件丢失,则回退到远程URL)
并注册每个工具 operationId.

工具名称

每个工具名称构造为:

``

例子:

  • magicline_searchCustomers
  • magicline_device_activateDevice

工具名称卫生规则:

  • 非字母数字字符替换为 _.
  • 以数字开头的名称前缀为 op_.
  • 如果发生碰撞, _2, _3, ...附后。

工具输入

规范生成的工具接受具有这些可选字段的单个JSON对象
(取决于端点):

  • pathParams:路径参数 {param} 片段
  • query:查询参数
  • headerParams:规范定义的标头参数
  • headers:附加标题
  • body:JSON正文
  • rawBody:生坯串
  • rawBodyBase64:原始主体为base64
  • multipart:多部分表单数据部分

执行的规则:

  • 只有一个 body, rawBody, rawBodyBase64, multipart 可以设置。
  • 如果规范将车身标记为所需,则工具将强制执行。
  • 只有在规范声明时才允许使用多部分 multipart/form-data.

多部分格式

当 multipart 支持,每个部分都是以下之一:

  • { "kind": "json", "name": "...", "data": { ... } }
  • { "kind": "text", "name": "...", "data": "...", "contentType": "..." }
  • { "kind": "binary", "name": "...", "dataBase64": "...", "filename": "...", "contentType": "..." }

通用工具

magicline_request

用于对OpenAPI基本URL的即席调用。

输入:

  • method: GET · POST · PUT · DELETE · HEAD
  • path:相对路径类 /v1/customers
  • query, headers, body, rawBody, rawBodyBase64

magicline_request_multipart

用于对OpenAPI基本URL的ad-hoc多部分调用。

输入:

  • method: POST | PUT
  • path:相对路径类 /v1/customers/{id}/documents
  • query, headers, parts

响应格式

所有工具都返回文本响应:

  • JSON响应以文本形式打印。
  • 非JSON响应返回 { contentType, body } 作为JSON文本。

错误会返回如下文本消息:```
Request failed:


## 日志记录

服务器仅记录到stderr(stdio要求)。

## 脚本

- `npm run update-openapi`:将所有四个规格下载并存储到 `src/`
- `npm run build`:编译为 `build/` 并将规格复制到 `build/`

## 文件布局

- `src/index.ts`:服务器实现
- `src/*.json`:OpenAPI规范
- `build/index.js`:已编译服务器
- `build/*.json`:复制运行时的规范
- `scripts/fetch-openapi.mjs`:规范下载器

## 客户端集成(stdio)

此 MCP 通过 stdio 在本地运行。任何可以启动本地进程的客户端都可以工作。

**Codex(CLI和IDE扩展)**

Codex 支持 STDIO 服务器,并在 CLI 和 IDE 之间共享 MCP 配置。
您可以通过 CLI 或 `config.toml` 配置 。

命令行界面(stdio):```bash
codex mcp add magicline \
--env MAGICLINE_BASE_URL=https://... \
--env MAGICLINE_API_KEY=... \
-- node /absolute/path/to/magicline-mcp-server/build/index.js

config.toml (全球或项目):```toml
[mcp_servers.magicline]
command = "node"
args = ["/absolute/path/to/magicline-mcp-server/build/index.js"]

[mcp_servers.magicline.env]
MAGICLINE_BASE_URL = "https://..."
MAGICLINE_API_KEY = "..."


**克劳德代码(CLI)**

Claude Code 可以添加本地 stdio 服务器。重要:所有选项都在服务器名称之前。
和 `--` 将 Claude 选项与您的服务器命令分开。```bash
claude mcp add --transport stdio \
--env MAGICLINE_BASE_URL=https://... \
--env MAGICLINE_API_KEY=... \
magicline -- node /absolute/path/to/magicline-mcp-server/build/index.js

克劳德桌面

Claude Desktop 可以通过 MCP 服务器 claude_desktop_config.json 装载 。在那里添加条目
mcpServers 重新启动 Claude Desktop。json { "mcpServers": { "magicline": { "command": "node", "args": ["/absolute/path/to/magicline-mcp-server/build/index.js"], "env": { "MAGICLINE_BASE_URL": "https://...", "MAGICLINE_API_KEY": "..." } } } }

其他 MCP 客户端 (HTTP)

一些客户端,如VS代码(Copilot代理模式)和光标通过JSON文件配置MCP服务器
麻省理工学院 type: "http" 和 url这是为基于HTTP的MCP服务器设计的。如果你这个项目
以后作为HTTP服务器运行,您可以查看其HTTP格式。

故障排除

  • Missing MAGICLINE_BASE_URL 或 Missing MAGICLINE_API_KEY:
  • 在MCP客户端配置中设置env变量(而不仅仅是shell)。
  • Path must be relative:
  • 使用 /v1/... 调用通用工具时的样式路径(没有完整的URL)。
  • This endpoint does not accept JSON bodies:
  • 使用 multipart 如果规范要求 multipart/form-data.
  • Request body is required:
  • 提供以下之一 body, rawBody, rawBodyBase64,或 multipart.

安全说明

  • 不要泄露秘密。使用env变量或本地变量 .env 文件。
  • 保持基本URL没有尾随斜线。

开发说明

  • TypeScript源代码位于 src/.
  • 服务器需要以下规格 src/*.json 在运行时。
  • 您可以随时通过以下方式重新生成规格 npm run update-openapi.
  • npm test 目前是一个占位符。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Magicline MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Magicline MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Magicline MCP 收费吗?

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

Magicline MCP 需要 API Key 吗?

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

Magicline MCP 支持哪些客户端?

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

Magicline MCP 能提供哪些能力?

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

热门专题

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

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