docs: update commands for pnpm workflow

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
Jax 2026-03-13 17:10:14 +08:00
parent 380738c4de
commit 786a20c5d0

View File

@ -5,7 +5,7 @@
## 当前状态V1 Alpha ## 当前状态V1 Alpha
当前模板支持: 当前模板支持:
- Node.js 20+ 运行时 - Node.js 20.19+ 运行时
- 单包架构 - 单包架构
- 协议安全的本地 Stdio 传输(主要方式) - 协议安全的本地 Stdio 传输(主要方式)
- Streamable HTTP 传输(次要方式) - Streamable HTTP 传输(次要方式)
@ -20,19 +20,19 @@ Stdio 是本模板在本地开发以及与 Claude 等桌面 LLM 客户端集成
1. **安装依赖** 1. **安装依赖**
```bash ```bash
npm install pnpm install
``` ```
2. **使用 MCP Inspector 运行** 2. **使用 MCP Inspector 运行**
模板在 `package.json` 中提供了协议安全的启动配置,用于避免 stdout 被污染。你可以使用以下命令测试服务端: 模板在 `package.json` 中提供了协议安全的启动配置,用于避免 stdout 被污染。你可以使用以下命令测试服务端:
```bash ```bash
npx @modelcontextprotocol/inspector node ./node_modules/tsx/dist/cli.mjs src/stdio.ts pnpm dlx @modelcontextprotocol/inspector node ./node_modules/tsx/dist/cli.mjs src/stdio.ts
``` ```
3. **构建项目** 3. **构建项目**
如果你要为生产环境做准备,或使用编译后的入口文件,可以执行: 如果你要为生产环境做准备,或使用编译后的入口文件,可以执行:
```bash ```bash
npm run build pnpm build
``` ```
## 使用方式HTTP ## 使用方式HTTP
@ -41,7 +41,7 @@ HTTP 传输基于 Node 原生的 `StreamableHTTPServerTransport`,适用于远
1. **启动 HTTP 服务** 1. **启动 HTTP 服务**
```bash ```bash
npm run dev:http pnpm dev:http
``` ```
服务默认监听 `127.0.0.1:3000`。你也可以通过 `HTTP_PORT` 环境变量自定义端口。 服务默认监听 `127.0.0.1:3000`。你也可以通过 `HTTP_PORT` 环境变量自定义端口。
@ -51,9 +51,9 @@ HTTP 传输基于 Node 原生的 `StreamableHTTPServerTransport`,适用于远
## 开发与测试 ## 开发与测试
- **类型检查**`npm run typecheck` - **类型检查**`pnpm typecheck`
- **测试**`npm test`(运行 stdio、HTTP 和核心逻辑的 Vitest smoke tests - **测试**`pnpm test`(运行 stdio、HTTP 和核心逻辑的 Vitest smoke tests
- **开发模式(核心逻辑)**`npm run dev`(执行 `src/index.ts` - **开发模式(核心逻辑)**`pnpm dev`(执行 `src/index.ts`
## 仓库结构 ## 仓库结构
@ -86,6 +86,6 @@ HTTP 传输基于 Node 原生的 `StreamableHTTPServerTransport`,适用于远
## V1 限制 ## V1 限制
- **无鉴权**HTTP 传输不包含内置鉴权能力。 - **无鉴权**HTTP 传输不包含内置鉴权能力。
- **仅支持 Node**:当前专门针对 Node.js 20+ 进行适配。 - **仅支持 Node**:当前专门针对 Node.js 20.19+ 进行适配。
- **非 Monorepo**:设计目标是独立项目模板,而不是多包仓库。 - **非 Monorepo**:设计目标是独立项目模板,而不是多包仓库。
- **本地优先**V1 暂未提供面向云服务商的部署指南。 - **本地优先**V1 暂未提供面向云服务商的部署指南。