run402-mcp 3.7.5 → 3.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.zh-CN.md DELETED
@@ -1,169 +0,0 @@
1
- # run402-mcp
2
-
3
- [Run402](https://run402.com) 的 MCP 服务器 — 从任何 MCP 兼容客户端创建和管理 AI 原生 Postgres 数据库。
4
-
5
- > **免费试用 7 天完整后端(测试网)。进阶/团队版可用 USDC 或 Stripe 支付。**
6
- > 数据库 + REST API + 鉴权 + 存储 + 静态站点 + 函数。无需云账号。
7
-
8
- [English](./README.md) | 简体中文
9
-
10
- ## 快速开始
11
-
12
- ```bash
13
- npx run402-mcp
14
- ```
15
-
16
- ## 工具列表
17
-
18
- | 工具 | 说明 |
19
- |------|------|
20
- | `provision_postgres_project` | 创建新的 Postgres 数据库(prototype/hobby/team 等级) |
21
- | `run_sql` | 对项目执行 SQL(DDL 或查询) |
22
- | `rest_query` | 通过 PostgREST 查询/修改数据 |
23
- | `renew_project` | 续期数据库租约 |
24
- | `deploy_site` | 部署静态 HTML/CSS/JS 站点 |
25
- | `deploy_function` | 部署 Node 22 Serverless 函数 |
26
- | `invoke_function` | 调用已部署的函数 |
27
- | `get_function_logs` | 获取函数日志,可按 `since` 和 routed `request_id` 过滤 |
28
- | `set_secret` | 设置函数环境变量 |
29
-
30
- ## 定价
31
-
32
- | 等级 | 价格 | 租期 | 存储 | API 调用 |
33
- |------|------|------|------|----------|
34
- | Prototype 原型 | 免费(测试网) | 7 天 | 250 MB | 50 万次 |
35
- | Hobby 进阶 | $5 / ¥36 | 30 天 | 1 GB | 500 万次 |
36
- | Team 团队 | $20 / ¥145 | 30 天 | 10 GB | 5000 万次 |
37
-
38
- 仅创建和续期需要付款。后续 REST/鉴权/存储请求使用返回的密钥,无需额外付费。
39
-
40
- ## 客户端配置
41
-
42
- ### Claude Desktop
43
-
44
- 添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`:
45
-
46
- ```json
47
- {
48
- "mcpServers": {
49
- "run402": {
50
- "command": "npx",
51
- "args": ["-y", "run402-mcp"]
52
- }
53
- }
54
- }
55
- ```
56
-
57
- ### Cursor
58
-
59
- 添加到项目中的 `.cursor/mcp.json`:
60
-
61
- ```json
62
- {
63
- "mcpServers": {
64
- "run402": {
65
- "command": "npx",
66
- "args": ["-y", "run402-mcp"]
67
- }
68
- }
69
- }
70
- ```
71
-
72
- ### Cline
73
-
74
- 在 Cline MCP 设置中添加:
75
-
76
- ```json
77
- {
78
- "mcpServers": {
79
- "run402": {
80
- "command": "npx",
81
- "args": ["-y", "run402-mcp"]
82
- }
83
- }
84
- }
85
- ```
86
-
87
- ### Claude Code
88
-
89
- ```bash
90
- claude mcp add run402 -- npx -y run402-mcp
91
- ```
92
-
93
- ### OpenClaw
94
-
95
- Run402 已发布为 OpenClaw Skill。支持所有 OpenClaw 兼容的模型和平台,包括:
96
-
97
- - **豆包 Doubao**(字节跳动 ArkClaw)
98
- - **Kimi**(月之暗面)
99
- - **GLM**(智谱)
100
- - **MiniMax**
101
-
102
- ## 工作流程
103
-
104
- 1. **创建项目** — 调用 `provision_postgres_project` 创建数据库。服务器自动处理 x402 支付协商,并在本地保存凭证。
105
- 2. **构建应用** — 用 `run_sql` 创建表结构,`rest_query` 插入/查询数据,`blob_put` 管理文件存储。
106
- 3. **部署上线** — 用 `deploy_site` 部署前端,`deploy_function` 部署后端函数。
107
- 4. **续期维护** — 在租约到期前调用 `renew_project`。
108
-
109
- ### 支付流程
110
-
111
- 创建和续期需要 x402 微支付。当需要付款时,工具会返回支付详情(而不是错误),以便 LLM 可以分析并引导用户完成支付。
112
-
113
- ### 密钥存储
114
-
115
- 项目凭证保存在 `~/.config/run402/projects.json`(权限 `0600`)。每个项目存储:
116
- - `anon_key` — 公开查询用(遵循行级安全策略)
117
- - `service_key` — 管理操作用(绕过行级安全策略)
118
- - `tier` — prototype、hobby 或 team
119
- - `expires_at` — 租约到期时间
120
-
121
- ## 智能体额度(Agent Allowance)
122
-
123
- > 给智能体一个额度,不是钱包。
124
-
125
- Run402 支持预付费、硬限额的智能体额度模式:
126
- - **预付制** — 像充值卡一样预存额度
127
- - **硬限额** — 智能体不会超支
128
- - **可撤销** — 随时暂停或取消
129
- - **可追溯** — 每笔交易都有记录
130
-
131
- 了解更多:[run402.com/agent-allowance](https://run402.com/agent-allowance)
132
-
133
- ## 应用模板(一键复制)
134
-
135
- Run402 上的公开应用可以一键复制(Fork),每个副本拥有独立的数据库、鉴权、存储和 URL。
136
-
137
- - 浏览可用应用:[run402.com/apps](https://run402.com/apps)
138
- - API:`GET https://api.run402.com/v1/apps`
139
- - 复制应用:`POST /v1/fork/:tier` + `{ "version_id": "...", "name": "my-copy" }`
140
-
141
- 模板发布者可获得下游实例续费的 **20% 持续分成**。
142
-
143
- ## 环境变量
144
-
145
- | 变量 | 默认值 | 说明 |
146
- |------|--------|------|
147
- | `RUN402_API_BASE` | `https://api.run402.com` | API 基础 URL |
148
- | `RUN402_CONFIG_DIR` | `~/.config/run402` | 密钥存储目录 |
149
-
150
- ## 相关链接
151
-
152
- - **中文落地页**:[run402.com/zh-cn](https://run402.com/zh-cn)
153
- - **完整 API 文档**:[run402.com/llms.txt](https://run402.com/llms.txt)
154
- - **OpenAPI 规范**:[run402.com/openapi.json](https://run402.com/openapi.json)
155
- - **应用市场**:[run402.com/apps](https://run402.com/apps)
156
- - **API 状态**:[api.run402.com/health](https://api.run402.com/health)
157
- - **npm**:[npmjs.com/package/run402-mcp](https://www.npmjs.com/package/run402-mcp)
158
- - **GitHub**:[github.com/kychee-com/run402](https://github.com/kychee-com/run402)
159
-
160
- ## 开发
161
-
162
- ```bash
163
- npm run build
164
- npm run test:skill
165
- ```
166
-
167
- ## 许可证
168
-
169
- MIT