swiftipedia-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# Swiftipedia MCP Server
+
+Model Context Protocol (MCP) server for accessing [Swiftipedia](https://swiftipedia.org) documentation.
+
+## Installation
+
+```bash
+npx -y swiftipedia-mcp-server
+```
+
+## Usage with Cursor
+
+Add to your `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "swiftipedia": {
+      "command": "npx",
+      "args": ["-y", "swiftipedia-mcp-server"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `search_symbols` - Search for SwiftUI/Swift API symbols
+- `get_symbol_details` - Get complete documentation for a symbol
+- `get_examples` - Get code examples for a symbol
+- `browse_module` - List all symbols in a module
+
+## License
+
+MIT
+

package/dist/api.d.ts

@@ -0,0 +1,44 @@
+interface SearchResult {
+    name: string;
+    type: string;
+    module: string;
+    description: string;
+    url: string;
+    availability?: string[];
+}
+interface CodeExample {
+    code: string;
+    description?: string;
+}
+interface SymbolDetails {
+    name: string;
+    type: string;
+    module: string;
+    description: string;
+    declaration: string;
+    availability: string[];
+    examples: CodeExample[];
+    relatedSymbols: {
+        name: string;
+        url: string;
+    }[];
+    conformsTo?: string[];
+    url: string;
+}
+export declare class SwiftipediaAPI {
+    private symbolsCache;
+    private detailsCache;
+    private cdnBase;
+    constructor(cdnBase: string);
+    private loadSymbols;
+    private fetchDocumentation;
+    private extractText;
+    private extractExamples;
+    private calculateRelevance;
+    searchSymbols(query: string, moduleFilter?: string, limit?: number): Promise<SearchResult[]>;
+    getSymbolDetails(path: string): Promise<SymbolDetails>;
+    getExamples(path: string): Promise<CodeExample[]>;
+    browseModule(module: string, categoryFilter?: string, limit?: number): Promise<SearchResult[]>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAKA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;YAIb,WAAW;YAiBX,kBAAkB;IAkBhC,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,kBAAkB;IAiBpB,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC;IAmDpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwEtD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAUjD,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC;CAuC3B"}

package/dist/api.js

@@ -0,0 +1,223 @@
+export class SwiftipediaAPI {
+    constructor(cdnBase) {
+        this.symbolsCache = null;
+        this.detailsCache = new Map();
+        this.cdnBase = cdnBase;
+    }
+    async loadSymbols() {
+        if (this.symbolsCache) {
+            return this.symbolsCache;
+        }
+        const url = `${this.cdnBase}/symbols.json`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch symbols: ${response.statusText}`);
+        }
+        const data = await response.json();
+        this.symbolsCache = data;
+        return this.symbolsCache;
+    }
+    async fetchDocumentation(path) {
+        if (this.detailsCache.has(path)) {
+            return this.detailsCache.get(path);
+        }
+        let cleanPath = path.replace(/^\/documentation\//, "");
+        const url = `${this.cdnBase}/documentation/data/documentation/${cleanPath}.json`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Symbol not found: ${path}`);
+        }
+        const data = await response.json();
+        this.detailsCache.set(path, data);
+        return data;
+    }
+    extractText(content) {
+        if (!content)
+            return "";
+        return content
+            .map((item) => {
+            if (item.type === "text")
+                return item.text;
+            if (item.type === "codeVoice")
+                return `\`${item.code}\``;
+            if (item.inlineContent)
+                return this.extractText(item.inlineContent);
+            return "";
+        })
+            .join("");
+    }
+    extractExamples(sections) {
+        const examples = [];
+        for (const section of sections) {
+            if (section.kind === "content" && section.content) {
+                for (const item of section.content) {
+                    if (item.type === "codeListing" && item.syntax === "swift") {
+                        examples.push({
+                            code: item.code.join("\n"),
+                            description: undefined,
+                        });
+                    }
+                }
+            }
+        }
+        return examples;
+    }
+    calculateRelevance(symbol, query) {
+        const lowerQuery = query.toLowerCase();
+        const lowerTitle = symbol.title.toLowerCase();
+        if (lowerTitle === lowerQuery)
+            return 100;
+        if (lowerTitle.startsWith(lowerQuery))
+            return 90;
+        if (lowerTitle.includes(lowerQuery))
+            return 70;
+        const words = lowerQuery.split(/\s+/);
+        const matchedWords = words.filter((word) => lowerTitle.includes(word)).length;
+        if (matchedWords > 0)
+            return 50 + (matchedWords / words.length) * 20;
+        return 0;
+    }
+    async searchSymbols(query, moduleFilter, limit = 10) {
+        const symbols = await this.loadSymbols();
+        let filtered = symbols.filter((symbol) => {
+            if (moduleFilter &&
+                !symbol.url.includes(`/documentation/${moduleFilter}/`)) {
+                return false;
+            }
+            return this.calculateRelevance(symbol, query) > 0;
+        });
+        filtered.sort((a, b) => {
+            return this.calculateRelevance(b, query) - this.calculateRelevance(a, query);
+        });
+        filtered = filtered.slice(0, limit);
+        const results = [];
+        for (const symbol of filtered) {
+            const module = symbol.url.split("/")[2] || "unknown";
+            try {
+                const doc = await this.fetchDocumentation(symbol.url);
+                const description = doc.abstract ? this.extractText(doc.abstract) : "";
+                const type = doc.metadata?.symbolKind || "symbol";
+                const platforms = doc.metadata?.platforms?.map((p) => p.name) || [];
+                results.push({
+                    name: symbol.title,
+                    type,
+                    module,
+                    description,
+                    url: `https://swiftipedia.org${symbol.url}`,
+                    availability: platforms,
+                });
+            }
+            catch (error) {
+                results.push({
+                    name: symbol.title,
+                    type: "unknown",
+                    module,
+                    description: "",
+                    url: `https://swiftipedia.org${symbol.url}`,
+                });
+            }
+        }
+        return results;
+    }
+    async getSymbolDetails(path) {
+        const doc = await this.fetchDocumentation(path);
+        const name = doc.metadata?.title || "Unknown";
+        const type = doc.metadata?.symbolKind || "symbol";
+        const module = path.split("/")[2] || "unknown";
+        const description = doc.abstract ? this.extractText(doc.abstract) : "";
+        let declaration = "";
+        if (doc.primaryContentSections) {
+            for (const section of doc.primaryContentSections) {
+                if (section.kind === "declarations" && section.declarations?.[0]?.tokens) {
+                    declaration = section.declarations[0].tokens.map((t) => t.text).join("");
+                    break;
+                }
+            }
+        }
+        const examples = doc.primaryContentSections
+            ? this.extractExamples(doc.primaryContentSections)
+            : [];
+        const platforms = doc.metadata?.platforms?.map((p) => `${p.name} ${p.introducedAt}${p.deprecated ? " (deprecated)" : ""}`) || [];
+        const relatedSymbols = [];
+        if (doc.topicSections) {
+            for (const section of doc.topicSections) {
+                if (section.identifiers) {
+                    for (const id of section.identifiers.slice(0, 5)) {
+                        if (doc.references?.[id]) {
+                            const ref = doc.references[id];
+                            relatedSymbols.push({
+                                name: ref.title || ref.name || id,
+                                url: `https://swiftipedia.org${ref.url || ""}`,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        const conformsTo = [];
+        if (doc.relationshipsSections) {
+            for (const section of doc.relationshipsSections) {
+                if (section.type === "conformsTo" && section.identifiers) {
+                    for (const id of section.identifiers) {
+                        if (doc.references?.[id]) {
+                            conformsTo.push(doc.references[id].title || id);
+                        }
+                    }
+                }
+            }
+        }
+        return {
+            name,
+            type,
+            module,
+            description,
+            declaration,
+            availability: platforms,
+            examples,
+            relatedSymbols,
+            conformsTo: conformsTo.length > 0 ? conformsTo : undefined,
+            url: `https://swiftipedia.org${path}`,
+        };
+    }
+    async getExamples(path) {
+        const doc = await this.fetchDocumentation(path);
+        if (!doc.primaryContentSections) {
+            return [];
+        }
+        return this.extractExamples(doc.primaryContentSections);
+    }
+    async browseModule(module, categoryFilter, limit = 50) {
+        const symbols = await this.loadSymbols();
+        let filtered = symbols.filter((symbol) => {
+            return symbol.url.includes(`/documentation/${module}/`);
+        });
+        filtered = filtered.slice(0, limit * 2);
+        const results = [];
+        for (const symbol of filtered) {
+            try {
+                const doc = await this.fetchDocumentation(symbol.url);
+                const type = doc.metadata?.symbolKind || "symbol";
+                if (categoryFilter && type !== categoryFilter) {
+                    continue;
+                }
+                const description = doc.abstract ? this.extractText(doc.abstract) : "";
+                const platforms = doc.metadata?.platforms?.map((p) => p.name) || [];
+                results.push({
+                    name: symbol.title,
+                    type,
+                    module,
+                    description,
+                    url: `https://swiftipedia.org${symbol.url}`,
+                    availability: platforms,
+                });
+                if (results.length >= limit)
+                    break;
+            }
+            catch (error) {
+                continue;
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { SwiftipediaAPI } from "./api.js";
+const CDN_BASE = "https://dd5k9dbl5p183.cloudfront.net";
+const server = new Server({
+    name: "swiftipedia",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+const api = new SwiftipediaAPI(CDN_BASE);
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "search_symbols",
+                description: "Search for SwiftUI/Swift API symbols. Returns matching symbols with name, type, module, description, and URL. Supports fuzzy matching on symbol names and searches in descriptions.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search query (e.g. 'Button', 'VStack alignment', 'List selection')",
+                        },
+                        module: {
+                            type: "string",
+                            enum: ["swiftui", "unionchat", "uniontabview", "unionkeychain"],
+                            description: "Optional: filter by module",
+                        },
+                        limit: {
+                            type: "number",
+                            description: "Maximum number of results (default: 10)",
+                            default: 10,
+                        },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "get_symbol_details",
+                description: "Get complete documentation for a symbol including description, parameters, return type, availability, code examples, and related symbols.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Symbol path (e.g. '/documentation/swiftui/button')",
+                        },
+                    },
+                    required: ["path"],
+                },
+            },
+            {
+                name: "get_examples",
+                description: "Get all code examples for a symbol. Returns Swift code snippets extracted from the documentation.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Symbol path (e.g. '/documentation/swiftui/button')",
+                        },
+                    },
+                    required: ["path"],
+                },
+            },
+            {
+                name: "browse_module",
+                description: "List all symbols in a module or category. Useful for discovering available APIs.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        module: {
+                            type: "string",
+                            enum: ["swiftui", "unionchat", "uniontabview", "unionkeychain"],
+                            description: "Module name",
+                        },
+                        category: {
+                            type: "string",
+                            description: "Optional: filter by category (e.g. 'struct', 'protocol', 'method')",
+                        },
+                        limit: {
+                            type: "number",
+                            description: "Maximum number of results (default: 50)",
+                            default: 50,
+                        },
+                    },
+                    required: ["module"],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "search_symbols": {
+                const { query, module, limit = 10 } = args;
+                const results = await api.searchSymbols(query, module, limit);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(results, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_symbol_details": {
+                const { path } = args;
+                const details = await api.getSymbolDetails(path);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(details, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_examples": {
+                const { path } = args;
+                const examples = await api.getExamples(path);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(examples, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "browse_module": {
+                const { module, category, limit = 50 } = args;
+                const symbols = await api.browseModule(module, category, limit);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(symbols, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Swiftipedia MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "swiftipedia-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Swiftipedia documentation",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "swiftipedia-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepare": "tsc"
+  },
+  "keywords": ["mcp", "swiftui", "swift", "documentation"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "typescript": "^5.3.3"
+  }
+}
+
+

package/src/api.ts

@@ -0,0 +1,310 @@
+interface Symbol {
+  title: string;
+  url: string;
+}
+
+interface SearchResult {
+  name: string;
+  type: string;
+  module: string;
+  description: string;
+  url: string;
+  availability?: string[];
+}
+
+interface CodeExample {
+  code: string;
+  description?: string;
+}
+
+interface SymbolDetails {
+  name: string;
+  type: string;
+  module: string;
+  description: string;
+  declaration: string;
+  availability: string[];
+  examples: CodeExample[];
+  relatedSymbols: { name: string; url: string }[];
+  conformsTo?: string[];
+  url: string;
+}
+
+export class SwiftipediaAPI {
+  private symbolsCache: Symbol[] | null = null;
+  private detailsCache = new Map<string, any>();
+  private cdnBase: string;
+
+  constructor(cdnBase: string) {
+    this.cdnBase = cdnBase;
+  }
+
+  private async loadSymbols(): Promise<Symbol[]> {
+    if (this.symbolsCache) {
+      return this.symbolsCache;
+    }
+
+    const url = `${this.cdnBase}/symbols.json`;
+    const response = await fetch(url);
+
+    if (!response.ok) {
+      throw new Error(`Failed to fetch symbols: ${response.statusText}`);
+    }
+
+    const data = await response.json() as Symbol[];
+    this.symbolsCache = data;
+    return this.symbolsCache;
+  }
+
+  private async fetchDocumentation(path: string): Promise<any> {
+    if (this.detailsCache.has(path)) {
+      return this.detailsCache.get(path);
+    }
+
+    let cleanPath = path.replace(/^\/documentation\//, "");
+    const url = `${this.cdnBase}/documentation/data/documentation/${cleanPath}.json`;
+
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Symbol not found: ${path}`);
+    }
+
+    const data = await response.json();
+    this.detailsCache.set(path, data);
+    return data;
+  }
+
+  private extractText(content: any[]): string {
+    if (!content) return "";
+
+    return content
+      .map((item) => {
+        if (item.type === "text") return item.text;
+        if (item.type === "codeVoice") return `\`${item.code}\``;
+        if (item.inlineContent) return this.extractText(item.inlineContent);
+        return "";
+      })
+      .join("");
+  }
+
+  private extractExamples(sections: any[]): CodeExample[] {
+    const examples: CodeExample[] = [];
+
+    for (const section of sections) {
+      if (section.kind === "content" && section.content) {
+        for (const item of section.content) {
+          if (item.type === "codeListing" && item.syntax === "swift") {
+            examples.push({
+              code: item.code.join("\n"),
+              description: undefined,
+            });
+          }
+        }
+      }
+    }
+
+    return examples;
+  }
+
+  private calculateRelevance(symbol: Symbol, query: string): number {
+    const lowerQuery = query.toLowerCase();
+    const lowerTitle = symbol.title.toLowerCase();
+
+    if (lowerTitle === lowerQuery) return 100;
+    if (lowerTitle.startsWith(lowerQuery)) return 90;
+    if (lowerTitle.includes(lowerQuery)) return 70;
+
+    const words = lowerQuery.split(/\s+/);
+    const matchedWords = words.filter((word) =>
+      lowerTitle.includes(word)
+    ).length;
+    if (matchedWords > 0) return 50 + (matchedWords / words.length) * 20;
+
+    return 0;
+  }
+
+  async searchSymbols(
+    query: string,
+    moduleFilter?: string,
+    limit: number = 10
+  ): Promise<SearchResult[]> {
+    const symbols = await this.loadSymbols();
+
+    let filtered = symbols.filter((symbol) => {
+      if (
+        moduleFilter &&
+        !symbol.url.includes(`/documentation/${moduleFilter}/`)
+      ) {
+        return false;
+      }
+      return this.calculateRelevance(symbol, query) > 0;
+    });
+
+    filtered.sort((a, b) => {
+      return this.calculateRelevance(b, query) - this.calculateRelevance(a, query);
+    });
+
+    filtered = filtered.slice(0, limit);
+
+    const results: SearchResult[] = [];
+    for (const symbol of filtered) {
+      const module = symbol.url.split("/")[2] || "unknown";
+
+      try {
+        const doc = await this.fetchDocumentation(symbol.url);
+        const description = doc.abstract ? this.extractText(doc.abstract) : "";
+        const type = doc.metadata?.symbolKind || "symbol";
+        const platforms = doc.metadata?.platforms?.map((p: any) => p.name) || [];
+
+        results.push({
+          name: symbol.title,
+          type,
+          module,
+          description,
+          url: `https://swiftipedia.org${symbol.url}`,
+          availability: platforms,
+        });
+      } catch (error) {
+        results.push({
+          name: symbol.title,
+          type: "unknown",
+          module,
+          description: "",
+          url: `https://swiftipedia.org${symbol.url}`,
+        });
+      }
+    }
+
+    return results;
+  }
+
+  async getSymbolDetails(path: string): Promise<SymbolDetails> {
+    const doc = await this.fetchDocumentation(path);
+
+    const name = doc.metadata?.title || "Unknown";
+    const type = doc.metadata?.symbolKind || "symbol";
+    const module = path.split("/")[2] || "unknown";
+    const description = doc.abstract ? this.extractText(doc.abstract) : "";
+
+    let declaration = "";
+    if (doc.primaryContentSections) {
+      for (const section of doc.primaryContentSections) {
+        if (section.kind === "declarations" && section.declarations?.[0]?.tokens) {
+          declaration = section.declarations[0].tokens.map((t: any) => t.text).join("");
+          break;
+        }
+      }
+    }
+
+    const examples = doc.primaryContentSections
+      ? this.extractExamples(doc.primaryContentSections)
+      : [];
+
+    const platforms =
+      doc.metadata?.platforms?.map(
+        (p: any) =>
+          `${p.name} ${p.introducedAt}${p.deprecated ? " (deprecated)" : ""}`
+      ) || [];
+
+    const relatedSymbols: { name: string; url: string }[] = [];
+    if (doc.topicSections) {
+      for (const section of doc.topicSections) {
+        if (section.identifiers) {
+          for (const id of section.identifiers.slice(0, 5)) {
+            if (doc.references?.[id]) {
+              const ref = doc.references[id];
+              relatedSymbols.push({
+                name: ref.title || ref.name || id,
+                url: `https://swiftipedia.org${ref.url || ""}`,
+              });
+            }
+          }
+        }
+      }
+    }
+
+    const conformsTo: string[] = [];
+    if (doc.relationshipsSections) {
+      for (const section of doc.relationshipsSections) {
+        if (section.type === "conformsTo" && section.identifiers) {
+          for (const id of section.identifiers) {
+            if (doc.references?.[id]) {
+              conformsTo.push(doc.references[id].title || id);
+            }
+          }
+        }
+      }
+    }
+
+    return {
+      name,
+      type,
+      module,
+      description,
+      declaration,
+      availability: platforms,
+      examples,
+      relatedSymbols,
+      conformsTo: conformsTo.length > 0 ? conformsTo : undefined,
+      url: `https://swiftipedia.org${path}`,
+    };
+  }
+
+  async getExamples(path: string): Promise<CodeExample[]> {
+    const doc = await this.fetchDocumentation(path);
+
+    if (!doc.primaryContentSections) {
+      return [];
+    }
+
+    return this.extractExamples(doc.primaryContentSections);
+  }
+
+  async browseModule(
+    module: string,
+    categoryFilter?: string,
+    limit: number = 50
+  ): Promise<SearchResult[]> {
+    const symbols = await this.loadSymbols();
+
+    let filtered = symbols.filter((symbol) => {
+      return symbol.url.includes(`/documentation/${module}/`);
+    });
+
+    filtered = filtered.slice(0, limit * 2);
+
+    const results: SearchResult[] = [];
+    for (const symbol of filtered) {
+      try {
+        const doc = await this.fetchDocumentation(symbol.url);
+        const type = doc.metadata?.symbolKind || "symbol";
+
+        if (categoryFilter && type !== categoryFilter) {
+          continue;
+        }
+
+        const description = doc.abstract ? this.extractText(doc.abstract) : "";
+        const platforms = doc.metadata?.platforms?.map((p: any) => p.name) || [];
+
+        results.push({
+          name: symbol.title,
+          type,
+          module,
+          description,
+          url: `https://swiftipedia.org${symbol.url}`,
+          availability: platforms,
+        });
+
+        if (results.length >= limit) break;
+      } catch (error) {
+        continue;
+      }
+    }
+
+    return results;
+  }
+}
+
+
+
+

package/src/index.ts

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { SwiftipediaAPI } from "./api.js";
+
+const CDN_BASE = "https://dd5k9dbl5p183.cloudfront.net";
+
+const server = new Server(
+  {
+    name: "swiftipedia",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+const api = new SwiftipediaAPI(CDN_BASE);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "search_symbols",
+        description:
+          "Search for SwiftUI/Swift API symbols. Returns matching symbols with name, type, module, description, and URL. Supports fuzzy matching on symbol names and searches in descriptions.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description:
+                "Search query (e.g. 'Button', 'VStack alignment', 'List selection')",
+            },
+            module: {
+              type: "string",
+              enum: ["swiftui", "unionchat", "uniontabview", "unionkeychain"],
+              description: "Optional: filter by module",
+            },
+            limit: {
+              type: "number",
+              description: "Maximum number of results (default: 10)",
+              default: 10,
+            },
+          },
+          required: ["query"],
+        },
+      },
+      {
+        name: "get_symbol_details",
+        description:
+          "Get complete documentation for a symbol including description, parameters, return type, availability, code examples, and related symbols.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            path: {
+              type: "string",
+              description:
+                "Symbol path (e.g. '/documentation/swiftui/button')",
+            },
+          },
+          required: ["path"],
+        },
+      },
+      {
+        name: "get_examples",
+        description:
+          "Get all code examples for a symbol. Returns Swift code snippets extracted from the documentation.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            path: {
+              type: "string",
+              description:
+                "Symbol path (e.g. '/documentation/swiftui/button')",
+            },
+          },
+          required: ["path"],
+        },
+      },
+      {
+        name: "browse_module",
+        description:
+          "List all symbols in a module or category. Useful for discovering available APIs.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            module: {
+              type: "string",
+              enum: ["swiftui", "unionchat", "uniontabview", "unionkeychain"],
+              description: "Module name",
+            },
+            category: {
+              type: "string",
+              description:
+                "Optional: filter by category (e.g. 'struct', 'protocol', 'method')",
+            },
+            limit: {
+              type: "number",
+              description: "Maximum number of results (default: 50)",
+              default: 50,
+            },
+          },
+          required: ["module"],
+        },
+      },
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case "search_symbols": {
+        const { query, module, limit = 10 } = args as any;
+        const results = await api.searchSymbols(query, module, limit);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(results, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "get_symbol_details": {
+        const { path } = args as any;
+        const details = await api.getSymbolDetails(path);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(details, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "get_examples": {
+        const { path } = args as any;
+        const examples = await api.getExamples(path);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(examples, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "browse_module": {
+        const { module, category, limit = 50 } = args as any;
+        const symbols = await api.browseModule(module, category, limit);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(symbols, null, 2),
+            },
+          ],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    const errorMessage =
+      error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ error: errorMessage }, null, 2),
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Swiftipedia MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});
+
+
+
+

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+
+
+
+