使用说明
简单的MCP
构建MCP服务器的最快方法。告诉AI你需要什么，或者自己写。
第1层兼容框架
简单来说，MCP是 一级兼容社区框架，提供模型上下文协议规范（2025-11-25）和所有活动标准跟踪SEP的100%覆盖。
- 1965年9月（MCP应用程序）：原生支持丰富的交互式UI。
- SEP-1036（URL引用）：安全的带外用户交互。
- 1977年9月（采样）：具有工具使用和上下文支持的高级LLM采样。
- SEP-2339（任务）：持久的异步后台操作。
查看全文 合规报告.
你能建造什么
Real-time dashboards • Interactive maps • Financial modeling • Data visualization
两种构建方式
路径1：让AI构建它（推荐）
随着 克劳德代码 或任何AI编码工具：
> Build me an MCP server that monitors system resources
and shows a real-time dashboard
人工智能使用Simply-MCP的工厂API生成一个完整的、可供生产的服务器。通过描述你想要更改的内容来迭代。
路径2：自己写
import { createServer, createTool } from 'simply-mcp';
export const server = createServer({
name: 'my-server',
version: '1.0.0',
});
export const addTool = createTool({
description: 'Add two numbers',
params: {
a: { type: 'number', description: 'First number' },
b: { type: 'number', description: 'Second number' },
},
handler: ({ a, b }) => ({ sum: a + b }),
});
npx simplymcp run server.ts # Run (stdio for Claude)
npx simplymcp run server.ts --port 3000 # Run (HTTP)
这两条路径都产生了相同的东西：一个具有工具、资源和可选UI的类型安全MCP服务器。
安装
npm install simply-mcp
裸安装仅拉取核心MCP运行时（SDK， zod, yargs,
MCP应用程序）。选择加入功能声明为 可选对等体
依赖项 --只安装服务器使用的那些：
| 您使用的功能 | 添加 |
|---|---|
| HTTP传输 | npm install hono @hono/node-server |
| WebSocket传输 | npm install ws |
.ts 通过CLI输入服务器 |
npm install esbuild tsx |
接口API（装饰器/ IServer) |
npm install typescript |
| OAuth（bcrypt哈希） | npm install bcrypt |
| OAuth（Redis存储） | npm install ioredis |
| 带有React UI的MCP应用程序 | npm install @babel/standalone @remote-dom/core @remote-dom/react |
| UI缩小（生产） | npm install postcss cssnano html-minifier-terser terser |
| HTML输入净化 | npm install dompurify |
| 代码执行沙盒 | npm install quickjs-emscripten |
| 文件监视开发模式 | npm install chokidar |
| 资源SQLite后端 | npm install better-sqlite3 |
| 快速路由器OAuth | npm install express |
缺少对等错误指向要安装的确切软件包。
一个代码库。多平台。
| 克劳德桌面 | ChatGPT | 您的应用程序 |
|---|---|---|
| ✓ | ✓ | ✓ |
写一次。OpenAI适配器是内置的。
特性
| 功能 | 它的作用 |
|---|---|
| MCP应用程序 | 使用React、Vue或任何框架的丰富UI |
| OpenAI 兼容 | 相同的代码部署到ChatGPT |
| 类型推断 | 定义一次，类型无处不在 |
| 代码执行 | 用于AI生成代码的沙盒QuickJS |
| Python处理程序 | 在一台服务器上混合TypeScript和Python |
| 多运输 | stdio、HTTP、WebSocket——任意选择 |
| 捆绑准备就绪 | npx simplymcp bundle → 单个文件 |
为什么选择MCP？
// The old way: schema, types, validation, handler — all separate
const schema = { name: 'add', inputSchema: { type: 'object', properties: { a: { type: 'number' } } } };
interface AddParams { a: number; b: number; }
// ...more boilerplate
// Simply-MCP: one definition, fully typed
export const addTool = createTool({
description: 'Add two numbers',
params: {
a: { type: 'number', description: 'First' },
b: { type: 'number', description: 'Second' },
},
handler: ({ a, b }) => ({ sum: a + b }), // Fully typed!
});
命令行界面
npx simplymcp lint server.ts # Validate before running
npx simplymcp run server.ts # Run (stdio)
npx simplymcp run server.ts --port 3000 # Run (HTTP)
npx simplymcp dev server.ts --port 3000 # Dev mode with hot reload
npx simplymcp bundle server.ts # Bundle for production
Claude桌面集成
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["simplymcp", "run", "/path/to/server.ts"]
}
}
}
文档
| 指南 | 说明 |
|---|---|
| 快速开始 | 5分钟后开始跑步 |
| AI工作流程 | 在人工智能的帮助下构建服务器 |
| api参考 | createServer、createTool、createResource、createApp |
| 命令行界面 | 完整命令参考 |
| 运输 | stdio、HTTP、WebSocket模式 |
| 代码执行 | 用于工具链的QuickJS沙盒 |
| 键入工具结果 | 规范 structuredContent + outputSchema 解析合同 |
| 捆绑 | 生产部署 |
| 示例 | 带注释的示例索引 |
| 常见问题 | 常见问题 |
示例
| 示例 | 说明 |
|---|---|
| minimal.ts | 绝对最小值（~20行） |
| complete.ts | 所有核心功能 |
| 代码执行.ts | 沙盒模式 |
许可证
Simply MCP可免费用于非商业用途（研究、个人项目、教育、评估）。商业用途需要单独的许可证。看 许可证 了解详情。
对于商业许可： licensing@cwinnov.com
与 模型上下文协议SDK 通过Anthropic。
