mcp嵌入式ui
跨语言规范和共享资产,用于将基于浏览器的工具浏览器嵌入到任何 主控程序 (模型上下文协议)服务器。
官方SDK: python (PyPI) | | 锈 (crates.io) | \[去 (即将推出)\]
______________________________________________________________________
快速开始
python SDK: aiperceptible/mcp嵌入式ui python
pip install mcp-embedded-ui
from fastapi import FastAPI from mcp_embedded_ui import create_mount
app = FastAPI()
Mount the explorer UI to your FastAPI app
app.routes.append(create_mount( tools=my_tools, handle_call=my_handler, prefix="/explorer" ))
Visit http://localhost:8000/explorer/
===“TypeScript” SDK: aiperceptible/mcp嵌入式ui脚本
npm install mcp-embedded-ui
import http from "node:http"; import { createNodeHandler } from "mcp-embedded-ui";
const handler = createNodeHandler(myTools, myHandler, { prefix: "/explorer", });
http.createServer(handler).listen(8000); // Visit http://localhost:8000/explorer/
===“生锈” SDK: aiperceptible/mcp嵌入ui锈迹
cargo.toml
[dependencies] mcp-embedded-ui = "0.4.0"
use mcp_embedded_ui::{ExplorerOptions, axum_handler};
let options = ExplorerOptions::default(); let app = Router::new().route("/explorer/*path", get(axum_handler));
这是什么?
如果你构建了一个MCP服务器,你的用户通过JSON与工具交互——没有视觉反馈,没有模式浏览器,也没有快速的测试方法。 mcp嵌入式ui 通过定义一组标准的HTTP端点和一个任何MCP服务器都可以用任何语言提供的自包含的HTML页面来解决这个问题。
┌───────────────────────────────────┐
│ Browser │
│ Tool list → Schema → Try it │
└──────────────┬────────────────────┘
│ HTTP / JSON
┌──────────────▼────────────────────┐
│ Your MCP Server │
│ + mcp-embedded-ui library │
│ (Python / TypeScript / Go / …) │
└───────────────────────────────────┘一个进口。一座山。完整的用户界面。
主要特点
嵌入式资源管理器页面提供:
- 工具列表 --浏览所有带有描述和注释的注册工具。
- 模式检查器 --展开任何工具以查看其完整的JSON模式(
inputSchema). - 试试控制台 --键入JSON参数,执行工具,立即查看结果。
- cURL导出 --复制一个现成的cURL命令以供执行。
- 身份验证支持 --在UI中输入与所有请求一起发送的Bearer令牌。
无构建步骤。没有CDN。没有外部依赖关系。整个UI是嵌入在服务器二进制文件/包中的单个HTML字符串。
开发人员文档
深度潜水
如何添加新语言
- 阅读 协议规范 --端点和数据形状的权威来源。
- 跟随 功能清单 实施顺序: F1 → F2 → F3 → F4 → F6 → F5.
- 使用 explorer.html 模板(不要修改HTML内容)。
- 确保您遵循 安全检查列表.
- 打开一个PR,将您的实现添加到此列表中!
设计原则
- 零前端构建 --没有npm/webpack/CDN。只有一个HTML字符串。
- 框架无关 --可挂载到任何地方的标准HTTP路由。
- 跨语言一致性 --跨Python、TS、Go等的相同用户体验。
- 缺省安全 --内置XSS保护和身份验证净化功能。
许可证
阿帕奇-2.0
