Example Server

MCP运维云端

提供方 danfking · 包名 @burnishdev/example-server

运维云端 stdio · 本地进程 API Key 社区 / 第三方
查看接入方式

一个无需LLM或API密钥的浏览器内MCP服务器交互工具,支持自动生成表单和丰富的结果可视化。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

MCP服务器TypeScript本地部署无LLM自动表单生成数据可视化本地运行

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
npx burnish -- npx -y @burnishdev/example-server

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Example Server当前 未标注 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

服务器档案

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

详细介绍

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

Burnish

Swagger UI for MCP servers.

Explore any MCP server in your browser. No LLM, no API key, no config.


快速入门```bash

npx burnish -- npx -y @burnishdev/example-server


就是这样。Burnish生成了示例MCP服务器,读取其工具列表,打开浏览器,并将每个工具呈现为交互式表单。示例服务器附带了十几个工具——创建错误报告、列出团队成员、搜索记录——这样你就可以点击、填写表单,并查看以卡片、表格和图表呈现的结果,而无需编写一行自己的MCP代码。

想在另一台服务器上尝试一下吗?点 `burnish` 在任何stdio或SSE MCP服务器上--请参阅 你能指出什么 在......下面

尝试托管演示: **blash-demo.fly.dev**

## 为什么是Burnish?

- **零法学硕士。** 没有OpenAI密钥,没有Anthropic密钥,没有推理成本。永远。资源管理器模式是100%确定性的——模式输入、形式输出、结果呈现。
- **零配置。** 点 `npx burnish` 在MCP服务器命令下,它运行。没有JSON文件,没有帐户,没有Docker。
- **零数据离开您的机器。** CLI在本地运行,仅与您指向的MCP服务器通信。默认情况下,没有分析像素,也没有遥测。

## 与替代方案相比

烧伤 · MCP检查员 · 复合材料/橡胶 · 史密斯利 · n8n
**没有LLM的作品** · ✅ · ✅ · ❌ · ➖ · ❌
**丰富的可视化** · ✅ 卡片、表格、图表 · ❌ 原始JSON · ➖ 有限 · ➖ 仅限注册表 · ➖ 节点输出
**任何MCP服务器** · ✅ · ✅ · ➖ 500预包装 · ➖ 仅浏览 · ➖ 自定义节点
**自动生成的表单** · ✅ 来自架构 · ❌ 手动JSON · ➖ 仅预装 · ❌ · ➖ 节点配置界面
**本地/私人** · ✅ 完全地✅ · ❌ 云 · ❌ 云 · ➖ 自主机(重型)
**零设置** · ✅ `npx burnish` · ✅ `npx` · ❌ 需要帐户 · ➖ 仅浏览 · ❌ 需要Docker
**可组合** · ✅ 任何服务器组合 · ❌ 单服务器 · ❌ 锁定生态系统 · ➖ · ➖ 工作流生成器

✅ 全力支持·➖ 部分/有限·❌ 不支持

## 你能指出什么```bash
# The Burnish example server — richest default demo
npx burnish -- npx -y @burnishdev/example-server

# Any published stdio MCP server
npx burnish -- npx -y @modelcontextprotocol/server-filesystem /tmp

# GitHub (needs a PAT)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_... \
npx burnish -- npx -y @modelcontextprotocol/server-github

# An SSE / HTTP MCP server
npx burnish --sse https://your-mcp-server.example.com/sse

# A multi-server config file
npx burnish --config ./mcp-servers.json

所有配置的服务器在启动时连接。他们的工具可以立即使用——可以从浏览器中发现、记录和执行。

适用于MCP服务器所有者

让您的用户在不克隆任何内容的情况下浏览您的服务器。请将此放入您的自述文件中:````markdown

npx burnish -- npx @your-org/your-mcp-server```
````

希望您的工具结果呈现为卡片、表格和图表,而不是原始JSON?请参阅 输出格式指南.

## 链接

- **托管演示** — blash-demo.fly.dev
- **讨论** — github/danfking/抛光/讨论
- **问题** — github/danfking/blush/issues
- **注册表** --Smithery,Glama,mcp.so(追踪于 #383)

## 特性

连接。浏览。执行。一切都是由服务器的工具模式驱动的。

- **即时工具发现** --列出的每个工具及其描述和输入模式
- **自动生成的表单** --JSON模式输入,交互式表单输出
- **丰富的结果** --响应呈现为卡片、表格、图表、统计栏,而不是原始JSON
- **完全私密** --在本地运行,没有外部调用,默认情况下没有遥测
- **零配置** — `npx burnish` 而你正在奔跑
- **深入导航** --可折叠部分和会话持久性
- **框架无关** --标准web组件,无React/Vue/Angular锁定
- **可主题化的** — `--burnish-*` CSS自定义属性
- **无构建步骤** --将组件作为ES模块从CDN导入

## 组件参考

10升3个web组件,每个组件由JSON属性驱动。下面的每个例子都是现场直播的 托管演示 --点击“试试”直接打开工具。

|组件|预览|关键属性|目的|实例|
|-----------|---------|----------------|---------|--------------|
| `` |  | `title`, `status`, `body`, `meta` (JSON), `item-id` |带有向下钻取功能的单个项目| 试试看 |
| `` |  | `items` (JSON: `[{label, value, color?}]`)|汇总指标/过滤药丸| 试试看 |
| `` |  | `title`, `columns` (JSON), `rows` (JSON), `status-field` |带有状态着色的表格数据| 试试看 |
| `` |  | `type` (线/条/甜甜圈), `config` (JSON)|Chart.js可视化| 试试看 |
| `` |  | `label`, `count`, `status`, `collapsed` |可折叠分组容器| 试试看 |
| `` |  | `label`, `value`, `unit`, `trend` (上/下/平)|单个KPI显示| 试试看 |
| `` |  | `role` (用户/助理), `content`, `streaming` |聊天泡泡| 试试看 |
| `` |  | `title`, `tool-id`, `fields` (JSON)|用户输入/工具执行| 试试看 |
| `` |  | `actions` (JSON: `[{label, action, prompt, icon?}]`)|上下文下一步按钮| 试试看 |
| `` |  | `steps` (JSON: `[{server, tool, status}]`)|实时工具链可视化| 试试看 |

**状态值:** `success`, `warning`, `error`, `muted`, `info` --通过CSS自定义属性映射到语义颜色。

**动作类型:** `read` (自动调用,安全)和 `write` (显示表单,需要用户确认)。

## SDK集成

### 中间件

只需一行即可将Burnish Explorer添加到MCP服务器:```typescript
import { withBurnishUI } from "burnish/middleware";
await withBurnishUI(server, { port: 3001 });

架构导出```bash

npx burnish export -- npx @your-org/your-server > schema.json


## 在您自己的项目中使用

### CDN(无构建步骤)```html

npm```bash

npm install @burnishdev/components

import '@burnishdev/components';

// Components auto-register with burnish-* prefix.
// Custom prefix:
import { BurnishCard } from '@burnishdev/components';
customElements.define('my-card', class extends BurnishCard {});
```

### 渲染器```bash
npm install @burnishdev/renderer
``````javascript
import { findStreamElements, appendStreamElement } from '@burnishdev/renderer';

const elements = findStreamElements(chunk);
for (const el of elements) {
appendStreamElement(container, stack, el, safeAttrs, sanitize);
}
```

## 配置

### MCP服务器

在中配置 `apps/demo/mcp-servers.json` 从源头运行时,或通过 `--config` 到CLI:```json
{
"mcpServers": {
"example": {
"command": "npx",
"args": ["-y", "@burnishdev/example-server"]
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}
```

所有配置的服务器在启动时连接。他们的工具立即可用。

## 发展```bash
git clone https://github.com/danfking/burnish.git
cd burnish
pnpm install          # Install all dependencies
pnpm build            # Build all packages
pnpm dev              # Start the demo
pnpm test             # Run Playwright tests
pnpm clean            # Clean all build artifacts

burnish/
├── packages/
│ ├── components/ @burnishdev/components — 10 Lit web components
│ ├── renderer/ @burnishdev/renderer — streaming parser + sanitizer
│ ├── app/ @burnishdev/app — drill-down logic + stream orchestration
│ ├── server/ @burnishdev/server — MCP hub + guards + intent resolver
│ ├── example-server/ @burnishdev/example-server — showcase MCP server (34 tools)
│ └── cli/ burnish CLI — npx burnish launcher + middleware
├── apps/
│ └── demo/
│ ├── server/ Hono API
│ └── public/ SPA shell (ES modules, no framework)
└── package.json pnpm workspace root


### 先决条件

- Node.js 20+
- pnpm 9+

## 运作原理```
┌──────────────────────────────────┐
│        MCP Servers                │
│  (filesystem, GitHub, DB, ...)    │
└──────────────┬───────────────────┘
│ tool calls / results
▼
┌──────────────────────────┐
│  Schema-Driven UI        │
│                          │
│  • List tools             │
│  • Generate forms         │
│  • Map results → comps    │
└──────────┬───────────────┘
│
▼
┌──────────────────────────┐
│  Streaming Renderer      │
│                          │
│  • Parse tags on arrival  │
│  • Sanitize (DOMPurify)  │
│  • Append to DOM         │
└──────────┬───────────────┘
│
▼
┌──────────────────────────┐
│  Web Components (Lit 3)  │
│                          │
│  • Shadow DOM isolation  │
│  • JSON attribute parsing│
│  • Event-driven drill-   │
│    down navigation       │
└──────────────────────────┘

Burnish读取MCP服务器的工具列表,从JSON模式生成表单,并将结果直接映射到组件——循环中没有LLM。一切都在本地运行。

即将推出:Navigator

Navigator是Explorer模式下计划中的LLM驱动的自然语言层——提出一个问题,Burnish会在您连接的服务器上选择合适的工具,用您今天看到的相同组件呈现答案。资源管理器模式(您现在使用的模式)保持免费、本地和零LLM。

加入候补名单→

隐私和遥测

Burnish收藏 选择加入,匿名遥测来衡量实际采用率(见 问题#382).它是 默认情况下关闭。在CLI的第一次交互式运行中,您将看到一个提示,询问是否启用它——按Enter键或其他任何键 y 保持它关闭。

我们发送的内容(仅当您选择加入时):

  • v --擦亮CLI版本
  • os --操作系统系列: darwin, linux, win32,或 other
  • node --Node.js主要版本
  • bucket --粗略调用计数桶: 1, 2-5, 6-20,或 21+
  • id --首次选择加入时生成的随机安装ID(UUID)
  • schema_version --有效载荷架构版本(当前 "1")

我们从不发送的内容: 服务器URL、工具名称、模式、参数、文件路径、主机名、用户名、IP地址,我们可以在TCP连接之外看到,或者来自MCP服务器的任何内容。没有每个工具或每个模式的跟踪。

如何随时退出:

  1. 设置环境变量 BURNISH_TELEMETRY=0 (也接受 false, off, no).这将覆盖任何存储的选项。
  2. 或删除/编辑存储的选择文件:
    - macOS/Linux: ~/.config/burnish/telemetry.json (荣誉 $XDG_CONFIG_HOME)
    - 窗户: %APPDATA%\burnish\telemetry.json

遥测是对 https://burnish-demo.fly.dev/telemetry/v1/ping 短暂的暂停。如果无法访问端点,CLI的行为相同——不会重试或排队。当没有存储选择时,在非交互式和CI环境中完全跳过遥测。

许可证

AGPL-3.0 --丹尼尔·金(@跳舞)

常见问题

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

在客户端按下面的安装命令接入:npx burnish -- npx -y @burnishdev/example-server。对应的包名是 @burnishdev/example-server。装完在客户端配置里引用同一个包或端点。

Example Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Example Server 收费吗?

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

Example Server 需要 API Key 吗?

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

Example Server 能提供哪些能力?

资料显示能力标签包括 本地运行、数据可视化、TypeScript。具体工具清单以官方文档为准。

Example Server 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Example Server 是本地还是远程?

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

热门专题

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

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