@meshstream/docs-mcp 0.0.0-stage → 0.1.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.
Files changed (40) hide show
  1. package/README.md +21 -2
  2. package/content/ai-coding.md +100 -0
  3. package/content/api/bootstrap.md +67 -0
  4. package/content/api/errors.md +34 -0
  5. package/content/best-practices.md +145 -0
  6. package/content/billing/usage.md +38 -0
  7. package/content/concepts/identity.md +23 -0
  8. package/content/concepts/multi-region.md +15 -0
  9. package/content/concepts/p2p.md +79 -0
  10. package/content/concepts/statistics.md +52 -0
  11. package/content/intro.md +54 -0
  12. package/content/legal/privacy.md +110 -0
  13. package/content/legal/terms.md +173 -0
  14. package/content/quickstart.md +198 -0
  15. package/content/sdk/android-advanced.md +228 -0
  16. package/content/sdk/android-setup.md +139 -0
  17. package/content/sdk/android.md +190 -0
  18. package/content/sdk/flutter-advanced.md +285 -0
  19. package/content/sdk/flutter-setup.md +123 -0
  20. package/content/sdk/flutter.md +91 -0
  21. package/content/sdk/ios-advanced.md +268 -0
  22. package/content/sdk/ios-setup.md +113 -0
  23. package/content/sdk/ios.md +156 -0
  24. package/content/sdk/overview.md +40 -0
  25. package/content/sdk/react-native-advanced.md +269 -0
  26. package/content/sdk/react-native-setup.md +86 -0
  27. package/content/sdk/react-native.md +52 -0
  28. package/content/sdk/uniapp-advanced.md +274 -0
  29. package/content/sdk/uniapp-setup.md +92 -0
  30. package/content/sdk/uniapp.md +55 -0
  31. package/content/sdk/web-advanced.md +241 -0
  32. package/content/sdk/web-setup.md +42 -0
  33. package/content/sdk/web.md +105 -0
  34. package/content/sdk/windows-advanced.md +237 -0
  35. package/content/sdk/windows-setup.md +53 -0
  36. package/content/sdk/windows.md +162 -0
  37. package/content/troubleshooting.md +122 -0
  38. package/package.json +21 -4
  39. package/src/catalog.mjs +164 -0
  40. package/src/server.mjs +43 -0
@@ -0,0 +1,164 @@
1
+ import fs from "node:fs/promises";
2
+ import { existsSync } from "node:fs";
3
+ import path from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+
6
+ const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
7
+ const bundledDocsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "content");
8
+ const defaultDocsRoot = existsSync(bundledDocsRoot)
9
+ ? bundledDocsRoot
10
+ : path.join(packageRoot, "apps", "developer-site", "docs");
11
+ const maxDocumentChars = 18_000;
12
+
13
+ const documentFiles = [
14
+ "intro.md",
15
+ "quickstart.md",
16
+ "ai-coding.md",
17
+ "best-practices.md",
18
+ "troubleshooting.md",
19
+ "concepts/p2p.md",
20
+ "concepts/statistics.md",
21
+ "concepts/identity.md",
22
+ "sdk/overview.md",
23
+ "sdk/web-setup.md",
24
+ "sdk/web.md",
25
+ "sdk/web-advanced.md",
26
+ "sdk/android-setup.md",
27
+ "sdk/android.md",
28
+ "sdk/android-advanced.md",
29
+ "sdk/ios-setup.md",
30
+ "sdk/ios.md",
31
+ "sdk/ios-advanced.md",
32
+ "sdk/windows-setup.md",
33
+ "sdk/windows.md",
34
+ "sdk/windows-advanced.md",
35
+ "sdk/flutter-setup.md",
36
+ "sdk/flutter.md",
37
+ "sdk/flutter-advanced.md",
38
+ "sdk/react-native-setup.md",
39
+ "sdk/react-native.md",
40
+ "sdk/react-native-advanced.md",
41
+ "sdk/uniapp-setup.md",
42
+ "sdk/uniapp.md",
43
+ "sdk/uniapp-advanced.md",
44
+ ];
45
+
46
+ function docsRoot() {
47
+ return path.resolve(process.env.MESHSTREAM_DOCS_ROOT?.trim() || defaultDocsRoot);
48
+ }
49
+
50
+ function titleFromMarkdown(markdown, fallback) {
51
+ const match = markdown.match(/^title:\s*["']?(.+?)["']?\s*$/m) || markdown.match(/^#\s+(.+)$/m);
52
+ return match?.[1]?.trim() || fallback;
53
+ }
54
+
55
+ function stripFrontMatter(markdown) {
56
+ return markdown.replace(/^---\n[\s\S]*?\n---\n/, "").trim();
57
+ }
58
+
59
+ function tokenize(value) {
60
+ return value.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((token) => token.length > 1);
61
+ }
62
+
63
+ function scoreDocument(query, document) {
64
+ const queryTokens = tokenize(query);
65
+ const haystack = `${document.title} ${document.path} ${document.text}`.toLowerCase();
66
+ return queryTokens.reduce((score, token) => score + (haystack.includes(token) ? (document.title.toLowerCase().includes(token) ? 4 : 1) : 0), 0);
67
+ }
68
+
69
+ async function readDocument(relativePath) {
70
+ if (!documentFiles.includes(relativePath)) throw new Error(`Unknown documentation path: ${relativePath}`);
71
+ const absolutePath = path.join(docsRoot(), relativePath);
72
+ const markdown = await fs.readFile(absolutePath, "utf8");
73
+ return {
74
+ path: relativePath,
75
+ title: titleFromMarkdown(markdown, relativePath),
76
+ text: stripFrontMatter(markdown),
77
+ url: `https://meshstream.net/docs/${relativePath.replace(/\.md$/, "").replaceAll("\\\\", "/")}`,
78
+ };
79
+ }
80
+
81
+ export async function loadDocuments() {
82
+ const documents = [];
83
+ for (const relativePath of documentFiles) {
84
+ try {
85
+ documents.push(await readDocument(relativePath));
86
+ } catch (error) {
87
+ if (error?.code !== "ENOENT") throw error;
88
+ }
89
+ }
90
+ return documents;
91
+ }
92
+
93
+ export async function searchDocs(query, limit = 5) {
94
+ const normalizedQuery = String(query || "").trim();
95
+ if (!normalizedQuery) return [];
96
+ const documents = await loadDocuments();
97
+ return documents
98
+ .map((document) => ({ document, score: scoreDocument(normalizedQuery, document) }))
99
+ .filter(({ score }) => score > 0)
100
+ .sort((a, b) => b.score - a.score || a.document.path.localeCompare(b.document.path))
101
+ .slice(0, Math.min(10, Math.max(1, Number(limit) || 5)))
102
+ .map(({ document, score }) => ({
103
+ path: document.path,
104
+ title: document.title,
105
+ score,
106
+ url: document.url,
107
+ excerpt: document.text.slice(0, 1_000),
108
+ }));
109
+ }
110
+
111
+ export async function getDocument(relativePath) {
112
+ const document = await readDocument(relativePath);
113
+ return { ...document, text: document.text.slice(0, maxDocumentChars) };
114
+ }
115
+
116
+ export async function getSdkRelease(platform = "all") {
117
+ const overview = await getDocument("sdk/overview.md");
118
+ const rows = overview.text.split("\n")
119
+ .filter((line) => /^\|/.test(line) && !/^\|\s*-/.test(line))
120
+ .map((line) => line.split("|").slice(1, -1).map((cell) => cell.trim()))
121
+ .filter((cells) => cells.length >= 4 && cells[0] !== "SDK")
122
+ .map(([sdk, version, android, apple]) => ({ sdk, version, android, apple }));
123
+ const normalized = String(platform || "all").trim().toLowerCase();
124
+ const filtered = normalized === "all" ? rows : rows.filter((row) => row.sdk.toLowerCase().includes(normalized));
125
+ return {
126
+ source: { path: overview.path, url: overview.url },
127
+ platform: normalized,
128
+ releases: filtered,
129
+ note: "仅返回官网公开版本表;发布前仍需从公共渠道验证精确包、哈希和兼容性。",
130
+ };
131
+ }
132
+
133
+ export async function getIntegrationGuide(platform = "web", framework = "") {
134
+ const normalized = String(platform || "web").trim().toLowerCase();
135
+ const map = {
136
+ web: ["sdk/web-setup.md", "sdk/web.md", "sdk/web-advanced.md"],
137
+ android: ["sdk/android-setup.md", "sdk/android.md", "sdk/android-advanced.md"],
138
+ ios: ["sdk/ios-setup.md", "sdk/ios.md", "sdk/ios-advanced.md"],
139
+ macos: ["sdk/ios-setup.md", "sdk/ios.md", "sdk/ios-advanced.md"],
140
+ windows: ["sdk/windows-setup.md", "sdk/windows.md", "sdk/windows-advanced.md"],
141
+ flutter: ["sdk/flutter-setup.md", "sdk/flutter.md", "sdk/flutter-advanced.md"],
142
+ reactnative: ["sdk/react-native-setup.md", "sdk/react-native.md", "sdk/react-native-advanced.md"],
143
+ "react-native": ["sdk/react-native-setup.md", "sdk/react-native.md", "sdk/react-native-advanced.md"],
144
+ uniapp: ["sdk/uniapp-setup.md", "sdk/uniapp.md", "sdk/uniapp-advanced.md"],
145
+ };
146
+ const paths = map[normalized] || map.web;
147
+ const guides = await Promise.all(paths.map(getDocument));
148
+ return {
149
+ platform: normalized,
150
+ framework: String(framework || "").trim() || undefined,
151
+ sources: guides.map(({ path: sourcePath, title, url, text }) => ({ path: sourcePath, title, url, text })),
152
+ };
153
+ }
154
+
155
+ export async function getTroubleshootingGuide(query = "") {
156
+ const document = await getDocument("troubleshooting.md");
157
+ const matches = query ? await searchDocs(query, 5) : [];
158
+ return {
159
+ source: { path: document.path, title: document.title, url: document.url },
160
+ query: String(query || "").trim() || undefined,
161
+ guide: document.text,
162
+ related: matches,
163
+ };
164
+ }
package/src/server.mjs ADDED
@@ -0,0 +1,43 @@
1
+ #!/usr/bin/env node
2
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
4
+ import { z } from "zod";
5
+ import { getIntegrationGuide, getSdkRelease, getTroubleshootingGuide, searchDocs } from "./catalog.mjs";
6
+
7
+ const server = new McpServer({ name: "meshstream-docs", version: "0.1.0" });
8
+
9
+ function result(value) {
10
+ return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
11
+ }
12
+
13
+ server.registerTool("search_docs", {
14
+ description: "Search the official MeshStream developer documentation. Read-only; results include source URLs and excerpts.",
15
+ inputSchema: {
16
+ query: z.string().min(1).describe("Question or keywords to search for"),
17
+ limit: z.number().int().min(1).max(10).optional().describe("Maximum number of results"),
18
+ },
19
+ }, async ({ query, limit }) => result({ query, results: await searchDocs(query, limit) }));
20
+
21
+ server.registerTool("get_sdk_release", {
22
+ description: "Read the public SDK version table from the official MeshStream documentation.",
23
+ inputSchema: {
24
+ platform: z.string().optional().describe("Platform filter such as web, android, ios, flutter, or all"),
25
+ },
26
+ }, async ({ platform }) => result(await getSdkRelease(platform)));
27
+
28
+ server.registerTool("get_integration_guide", {
29
+ description: "Return the official setup, integration, and advanced guide for a MeshStream SDK platform.",
30
+ inputSchema: {
31
+ platform: z.string().optional().describe("Platform such as web, android, ios, windows, flutter, react-native, or uniapp"),
32
+ framework: z.string().optional().describe("Optional framework or player context"),
33
+ },
34
+ }, async ({ platform, framework }) => result(await getIntegrationGuide(platform, framework)));
35
+
36
+ server.registerTool("get_troubleshooting_guide", {
37
+ description: "Return the official troubleshooting guide and related documentation matches.",
38
+ inputSchema: {
39
+ query: z.string().optional().describe("Optional symptom, error, or keyword"),
40
+ },
41
+ }, async ({ query }) => result(await getTroubleshootingGuide(query)));
42
+
43
+ await server.connect(new StdioServerTransport());