@meshstream/docs-mcp 0.4.0 → 0.5.0

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.
@@ -30,7 +30,7 @@ AI Coding 分成两个层次:MCP 负责查事实和生成结构化集成方案
30
30
  {
31
31
  "meshstream-docs": {
32
32
  "command": "npx",
33
- "args": ["--yes", "@meshstream/docs-mcp@0.4.0"]
33
+ "args": ["--yes", "@meshstream/docs-mcp@0.5.0"]
34
34
  }
35
35
  }
36
36
  ```
@@ -102,7 +102,7 @@ Android、iOS / macOS、Windows、Flutter、React Native 和 uni-app 使用相
102
102
 
103
103
  ## 已发布工具
104
104
 
105
- 官方工具的当前版本为 `0.4.0`,包含结构化集成规划、公开计费指引和 CodeBuddy 支持:
105
+ 官方工具的当前版本为 `0.5.0`,包含结构化集成规划、公开计费指引和 CodeBuddy 支持:
106
106
 
107
107
  - [`@meshstream/agent-skills`](https://www.npmjs.com/package/@meshstream/agent-skills):将接入、排错和 P2P 验收规则安装到 Codex、Cursor 或 Claude Code 项目。
108
108
  - [`@meshstream/docs-mcp`](https://www.npmjs.com/package/@meshstream/docs-mcp):只读官方文档 MCP,不读取客户项目文件,也不执行生产操作。
@@ -110,8 +110,8 @@ Android、iOS / macOS、Windows、Flutter、React Native 和 uni-app 使用相
110
110
  在项目根目录安装编辑器规则:
111
111
 
112
112
  ```bash
113
- npx --yes @meshstream/agent-skills@0.4.0 add --ide codex
114
- npx --yes @meshstream/agent-skills@0.4.0 add --ide codebuddy
113
+ npx --yes @meshstream/agent-skills@0.5.0 add --ide codex
114
+ npx --yes @meshstream/agent-skills@0.5.0 add --ide codebuddy
115
115
  ```
116
116
 
117
117
  ### 四种编辑器怎么使用
@@ -120,15 +120,15 @@ npx --yes @meshstream/agent-skills@0.4.0 add --ide codebuddy
120
120
 
121
121
  | 编辑器 | 安装命令 | 生成文件 | 使用方式 |
122
122
  | --- | --- | --- | --- |
123
- | Codex | `npx --yes @meshstream/agent-skills@0.4.0 add --ide codex` | `.codex/skills/meshstream-sdk-integration/SKILL.md` | 在项目中直接描述接入、排错或验收任务 |
124
- | Cursor | `npx --yes @meshstream/agent-skills@0.4.0 add --ide cursor` | `.cursor/rules/meshstream-sdk-integration.mdc` | 新建 Chat,按项目规则执行;需要时在 Rules 中启用该规则 |
125
- | Claude Code | `npx --yes @meshstream/agent-skills@0.4.0 add --ide claude` | `.claude/skills/meshstream-sdk-integration/SKILL.md` | 新建会话后直接提问,或使用 `/meshstream-sdk-integration` 调用技能 |
126
- | CodeBuddy | `npx --yes @meshstream/agent-skills@0.4.0 add --ide codebuddy` | `.codebuddy/skills/meshstream-sdk-integration/SKILL.md` | 重启项目会话后直接提问,技能会按平台选择文档 |
123
+ | Codex | `npx --yes @meshstream/agent-skills@0.5.0 add --ide codex` | `.codex/skills/meshstream-sdk-integration/SKILL.md` | 在项目中直接描述接入、排错或验收任务 |
124
+ | Cursor | `npx --yes @meshstream/agent-skills@0.5.0 add --ide cursor` | `.cursor/rules/meshstream-sdk-integration.mdc` | 新建 Chat,按项目规则执行;需要时在 Rules 中启用该规则 |
125
+ | Claude Code | `npx --yes @meshstream/agent-skills@0.5.0 add --ide claude` | `.claude/skills/meshstream-sdk-integration/SKILL.md` | 新建会话后直接提问,或使用 `/meshstream-sdk-integration` 调用技能 |
126
+ | CodeBuddy | `npx --yes @meshstream/agent-skills@0.5.0 add --ide codebuddy` | `.codebuddy/skills/meshstream-sdk-integration/SKILL.md` | 重启项目会话后直接提问,技能会按平台选择文档 |
127
127
 
128
128
  一次安装全部编辑器规则:
129
129
 
130
130
  ```bash
131
- npx --yes @meshstream/agent-skills@0.4.0 add --ide all --project .
131
+ npx --yes @meshstream/agent-skills@0.5.0 add --ide all --project .
132
132
  ```
133
133
 
134
134
  已有规则不会被覆盖;确认要更新时显式加 `--force`。安装完成后可以这样开始:
@@ -146,7 +146,7 @@ P2P 上传/下载字节、CDN 回退和释放证据。
146
146
  "mcpServers": {
147
147
  "meshstream-docs": {
148
148
  "command": "npx",
149
- "args": ["--yes", "@meshstream/docs-mcp@0.4.0"]
149
+ "args": ["--yes", "@meshstream/docs-mcp@0.5.0"]
150
150
  }
151
151
  }
152
152
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@meshstream/docs-mcp",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "private": false,
5
5
  "description": "Read-only MCP server for the MeshStream official developer documentation.",
6
6
  "repository": {
package/src/catalog.mjs CHANGED
@@ -18,6 +18,9 @@ const platformAliases = {
18
18
  java: "android",
19
19
  ios: "ios",
20
20
  "ios/ipados": "ios",
21
+ "ios/macos": "ios",
22
+ "ios / macos": "ios",
23
+ "ios-macos": "ios",
21
24
  macos: "macos",
22
25
  mac: "macos",
23
26
  apple: "ios",
@@ -83,6 +86,10 @@ function normalizePlatform(platform = "web") {
83
86
  return platformAliases[raw] || raw;
84
87
  }
85
88
 
89
+ function markdownLabel(value) {
90
+ return String(value || "").replace(/\[([^\]]+)\]\([^)]*\)/g, "$1").trim();
91
+ }
92
+
86
93
  const documentFiles = [
87
94
  "intro.md",
88
95
  "quickstart.md",
@@ -199,7 +206,13 @@ export async function getSdkRelease(platform = "all") {
199
206
  .map(([sdk, version, android, apple]) => ({ sdk, version, android, apple }));
200
207
  const normalized = String(platform || "all").trim().toLowerCase();
201
208
  const canonical = normalized === "all" ? "all" : normalizePlatform(normalized);
202
- const filtered = canonical === "all" ? rows : rows.filter((row) => normalizePlatform(row.sdk) === canonical || row.sdk.toLowerCase().includes(normalized));
209
+ const filtered = canonical === "all" ? rows : rows.filter((row) => {
210
+ const label = markdownLabel(row.sdk).toLowerCase();
211
+ return normalizePlatform(label) === canonical
212
+ || (canonical === "ios" && label.includes("ios"))
213
+ || (canonical === "macos" && label.includes("macos"))
214
+ || label.includes(normalized);
215
+ });
203
216
  return {
204
217
  source: { path: overview.path, url: overview.url },
205
218
  platform: canonical,
package/src/server.mjs CHANGED
@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
4
4
  import { z } from "zod";
5
5
  import { getBillingGuidance, getDocument, getIntegrationGuide, getIntegrationPlan, getPlatformMatrix, getSdkRelease, getTroubleshootingGuide, searchDocs } from "./catalog.mjs";
6
6
 
7
- const server = new McpServer({ name: "meshstream-docs", version: "0.3.0" });
7
+ const server = new McpServer({ name: "meshstream-docs", version: "0.5.0" });
8
8
 
9
9
  function result(value) {
10
10
  return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };