简单的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:自己写```typescript
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 }),
});
``````bash
npx simplymcp run server.ts # Run (stdio for Claude)
npx simplymcp run server.ts --port 3000 # Run (HTTP)
这两条路径都产生了相同的东西:一个具有工具、资源和可选UI的类型安全MCP服务器。
安装```bash
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?```typescript
// 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!
});
命令行界面```bash
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桌面集成```json
{
"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
NPM · GitHub · 问题
与 模型上下文协议SDK 通过Anthropic。
