al-go-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Job Louage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# AL-Go MCP Server
+
+A Model Context Protocol (MCP) server for accessing AL-Go documentation and workflows from the `microsoft/AL-Go` repository.
+
+## Features
+- Search and access AL-Go documentation and workflows
+- Works with public GitHub API (no token required for public repos)
+- Optional: Use a GitHub token for higher rate limits
+- Can be run via `npx` and configured in `.vscode/mcp.json`
+
+## Usage
+
+### 1. As a local or global npm package
+
+```
+npx al-go-mcp-server
+```
+
+### 2. In `.vscode/mcp.json`
+
+```json
+{
+  "servers": {
+    "al-go-docs": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["al-go-mcp-server"],
+      "env": {
+        "GITHUB_TOKEN": "your_token_here" // Optional
+      }
+    }
+  }
+}
+```
+
+## Development
+
+- Clone the repo
+- Run `npm install`
+- Run `npm run build`
+- Run `npm start` or `npx tsx src/index.ts`
+
+## License
+MIT

package/build/index.d.ts

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

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { AlGoService } from "./services/AlGoService.js";
+import { DocumentIndex } from "./services/DocumentIndex.js";
+/**
+ * AL-Go Documentation MCP Server
+ *
+ * This server provides access to AL-Go documentation through MCP protocol.
+ * It fetches documentation from the microsoft/AL-Go repository and provides
+ * search capabilities for AL-Go specific queries.
+ */
+// Initialize the MCP server
+const server = new McpServer({
+    name: "al-go-mcp-server",
+    version: "1.0.0"
+});
+// Initialize services
+const alGoService = new AlGoService();
+const documentIndex = new DocumentIndex();
+// Resource: Get AL-Go repository information
+server.registerResource("al-go-repo-info", "al-go://repo/info", {
+    title: "AL-Go Repository Information",
+    description: "Basic information about the AL-Go repository",
+    mimeType: "application/json"
+}, async (uri) => {
+    const repoInfo = await alGoService.getRepositoryInfo();
+    return {
+        contents: [{
+                uri: uri.href,
+                text: JSON.stringify(repoInfo, null, 2),
+                mimeType: "application/json"
+            }]
+    };
+});
+// Resource: Get specific AL-Go documentation file
+server.registerResource("al-go-doc", "al-go://docs/{path}", {
+    title: "AL-Go Documentation File",
+    description: "Get content from a specific AL-Go documentation file"
+}, async (uri) => {
+    // Extract path from URI
+    const urlPath = new URL(uri.href).pathname.replace('/docs/', '');
+    const content = await alGoService.getDocumentContent(urlPath);
+    return {
+        contents: [{
+                uri: uri.href,
+                text: content,
+                mimeType: "text/markdown"
+            }]
+    };
+});
+// Tool: Search AL-Go documentation
+server.registerTool("search-al-go-docs", {
+    title: "Search AL-Go Documentation",
+    description: "Search through AL-Go documentation for specific queries",
+    inputSchema: {
+        query: z.string().describe("Search query for AL-Go documentation"),
+        limit: z.number().default(10).describe("Maximum number of results to return")
+    }
+}, async ({ query, limit }) => {
+    try {
+        // Use direct API search instead of indexing
+        const results = await documentIndex.search(query, limit);
+        const resultText = results.map((result, index) => `${index + 1}. **${result.title}** (${result.path})\n   ${result.excerpt}\n   Score: ${result.score.toFixed(2)}\n`).join('\n');
+        return {
+            content: [{
+                    type: "text",
+                    text: `Found ${results.length} results for "${query}":\n\n${resultText}`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Error searching AL-Go documentation: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }],
+            isError: true
+        };
+    }
+});
+// Tool: Get AL-Go workflow examples
+server.registerTool("get-al-go-workflows", {
+    title: "Get AL-Go Workflow Examples",
+    description: "Get examples of AL-Go GitHub workflows",
+    inputSchema: {
+        workflowType: z.enum(["cicd", "deployment", "testing", "all"]).default("all").describe("Type of workflows to retrieve")
+    }
+}, async ({ workflowType }) => {
+    try {
+        const workflows = await alGoService.getWorkflowExamples(workflowType);
+        const workflowText = workflows.map((workflow) => `## ${workflow.name}\n**Path:** ${workflow.path}\n**Description:** ${workflow.description}\n\n\`\`\`yaml\n${workflow.content}\n\`\`\`\n`).join('\n---\n\n');
+        return {
+            content: [{
+                    type: "text",
+                    text: `AL-Go Workflow Examples (${workflowType}):\n\n${workflowText}`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Error retrieving AL-Go workflows: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }],
+            isError: true
+        };
+    }
+});
+// Tool: Refresh documentation cache
+server.registerTool("refresh-al-go-cache", {
+    title: "Refresh AL-Go Documentation Cache",
+    description: "Refresh the cached AL-Go documentation from the repository",
+    inputSchema: {
+        force: z.boolean().default(false).describe("Force refresh even if cache is recent")
+    }
+}, async ({ force }) => {
+    try {
+        await documentIndex.refresh(alGoService, force);
+        return {
+            content: [{
+                    type: "text",
+                    text: "AL-Go documentation cache refreshed successfully."
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Error refreshing AL-Go cache: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }],
+            isError: true
+        };
+    }
+});
+// Prompt: AL-Go project setup help
+server.registerPrompt("al-go-setup-help", {
+    title: "AL-Go Project Setup Help",
+    description: "Get help with setting up AL-Go for Business Central projects",
+    argsSchema: {
+        projectType: z.enum(["per-tenant-extension", "app-source", "template"]).describe("Type of AL-Go project"),
+        scenario: z.string().optional().describe("Specific scenario or requirement")
+    }
+}, ({ projectType, scenario }) => {
+    const basePrompt = `You are an expert in AL-Go for GitHub, Microsoft's development framework for Business Central extensions. Help the user set up an AL-Go project.
+
+Project Type: ${projectType}
+${scenario ? `Scenario: ${scenario}` : ''}
+
+Please provide step-by-step guidance including:
+1. Repository setup and structure
+2. Required configuration files
+3. Workflow configuration
+4. Best practices and common pitfalls
+
+Use the AL-Go documentation and examples available through the MCP tools to provide accurate, up-to-date information.`;
+    return {
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: basePrompt
+                }
+            }]
+    };
+});
+// Main function to start the server
+async function main() {
+    console.error("Starting AL-Go MCP Server...");
+    try {
+        // Document index will be initialized on first search request
+        // Start the server with stdio transport
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("AL-Go MCP Server is running on stdio");
+    }
+    catch (error) {
+        console.error("Failed to start AL-Go MCP Server:", error);
+        process.exit(1);
+    }
+}
+// Handle process termination
+process.on('SIGINT', () => {
+    console.error("Shutting down AL-Go MCP Server...");
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    console.error("Shutting down AL-Go MCP Server...");
+    process.exit(0);
+});
+// Start the server
+main().catch(error => {
+    console.error("Fatal error in AL-Go MCP Server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/services/AlGoService.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Service for interacting with the AL-Go GitHub repository
+ */
+export declare class AlGoService {
+    private octokit;
+    private owner;
+    private repo;
+    constructor();
+    /**
+     * Get basic repository information
+     */
+    getRepositoryInfo(): Promise<{
+        name: string;
+        description: string | null;
+        stars: number;
+        forks: number;
+        language: string | null;
+        lastUpdated: string;
+        defaultBranch: string;
+        url: string;
+        topics: string[] | undefined;
+    }>;
+    /**
+     * Get content of a specific documentation file
+     */
+    getDocumentContent(path: string): Promise<string>;
+    /**
+     * Get all documentation files from the repository
+     */
+    getDocumentationFiles(): Promise<Array<{
+        path: string;
+        content: string;
+        name: string;
+    }>>;
+    /**
+     * Get workflow examples from the repository
+     */
+    getWorkflowExamples(workflowType: string): Promise<Array<{
+        name: string;
+        path: string;
+        content: string;
+        description: string;
+    }>>;
+    /**
+     * Check if a workflow matches the specified type
+     */
+    private matchesWorkflowType;
+}
+//# sourceMappingURL=AlGoService.d.ts.map

package/build/services/AlGoService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlGoService.d.ts","sourceRoot":"","sources":["../../src/services/AlGoService.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,IAAI,CAAW;;IA8BvB;;OAEG;IACG,iBAAiB;;;;;;;;;;;IAwBvB;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBvD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAqD9F;;OAEG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA+CrI;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA0B5B"}

package/build/services/AlGoService.js

@@ -0,0 +1,204 @@
+import { Octokit } from "@octokit/rest";
+/**
+ * Service for interacting with the AL-Go GitHub repository
+ */
+export class AlGoService {
+    octokit;
+    owner = "microsoft";
+    repo = "AL-Go";
+    constructor() {
+        // Initialize Octokit with authentication
+        const githubToken = process.env.GITHUB_TOKEN;
+        const githubAppId = process.env.GITHUB_APP_ID;
+        const githubPrivateKey = process.env.GITHUB_PRIVATE_KEY;
+        const githubInstallationId = process.env.GITHUB_INSTALLATION_ID;
+        if (githubAppId && githubPrivateKey && githubInstallationId) {
+            // Use GitHub App authentication
+            this.octokit = new Octokit({
+                appId: githubAppId,
+                privateKey: githubPrivateKey.replace(/\\n/g, '\n'),
+                installationId: githubInstallationId,
+            });
+            console.log("AL-Go MCP Server: Using GitHub App authentication");
+        }
+        else if (githubToken) {
+            // Fallback to personal token
+            this.octokit = new Octokit({
+                auth: githubToken
+            });
+            console.log("AL-Go MCP Server: Using personal token authentication");
+        }
+        else {
+            // No authentication
+            this.octokit = new Octokit();
+            console.log("AL-Go MCP Server: Using unauthenticated requests (rate limited)");
+        }
+    }
+    /**
+     * Get basic repository information
+     */
+    async getRepositoryInfo() {
+        try {
+            const { data } = await this.octokit.rest.repos.get({
+                owner: this.owner,
+                repo: this.repo
+            });
+            return {
+                name: data.name,
+                description: data.description,
+                stars: data.stargazers_count,
+                forks: data.forks_count,
+                language: data.language,
+                lastUpdated: data.updated_at,
+                defaultBranch: data.default_branch,
+                url: data.html_url,
+                topics: data.topics
+            };
+        }
+        catch (error) {
+            console.error("Error fetching repository info:", error);
+            throw new Error(`Failed to fetch AL-Go repository information: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get content of a specific documentation file
+     */
+    async getDocumentContent(path) {
+        try {
+            const { data } = await this.octokit.rest.repos.getContent({
+                owner: this.owner,
+                repo: this.repo,
+                path: path
+            });
+            if ('content' in data && data.content) {
+                // Decode base64 content
+                return Buffer.from(data.content, 'base64').toString('utf8');
+            }
+            else {
+                throw new Error("File content not found or is a directory");
+            }
+        }
+        catch (error) {
+            console.error(`Error fetching document ${path}:`, error);
+            throw new Error(`Failed to fetch document ${path}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get all documentation files from the repository
+     */
+    async getDocumentationFiles() {
+        try {
+            const docs = [];
+            // Get repository tree to find documentation files
+            const { data: tree } = await this.octokit.rest.git.getTree({
+                owner: this.owner,
+                repo: this.repo,
+                tree_sha: "main",
+                recursive: "true"
+            });
+            // Filter for documentation files (markdown, txt, and specific documentation directories)
+            const docFiles = tree.tree.filter(item => item.type === 'blob' &&
+                item.path && (item.path.endsWith('.md') ||
+                item.path.endsWith('.txt') ||
+                item.path.includes('Actions/') ||
+                item.path.includes('Scenarios/') ||
+                item.path.includes('Workshop/') ||
+                item.path.includes('Documentation/') ||
+                item.path === 'README.md' ||
+                item.path === 'RELEASENOTES.md'));
+            // Fetch content for each documentation file (limit to avoid API rate limits)
+            const maxFiles = 50; // Reasonable limit for initial implementation
+            for (let i = 0; i < Math.min(docFiles.length, maxFiles); i++) {
+                const file = docFiles[i];
+                if (file.path) {
+                    try {
+                        const content = await this.getDocumentContent(file.path);
+                        docs.push({
+                            path: file.path,
+                            content: content,
+                            name: file.path.split('/').pop() || file.path
+                        });
+                    }
+                    catch (error) {
+                        console.error(`Failed to fetch ${file.path}:`, error);
+                        // Continue with other files
+                    }
+                }
+            }
+            return docs;
+        }
+        catch (error) {
+            console.error("Error fetching documentation files:", error);
+            throw new Error(`Failed to fetch documentation files: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get workflow examples from the repository
+     */
+    async getWorkflowExamples(workflowType) {
+        try {
+            const workflows = [];
+            // Get workflows from .github/workflows directory
+            const { data: workflowDir } = await this.octokit.rest.repos.getContent({
+                owner: this.owner,
+                repo: this.repo,
+                path: ".github/workflows"
+            });
+            if (Array.isArray(workflowDir)) {
+                const yamlFiles = workflowDir.filter(file => file.type === 'file' && file.name.endsWith('.yml') || file.name.endsWith('.yaml'));
+                for (const file of yamlFiles) {
+                    try {
+                        const content = await this.getDocumentContent(file.path);
+                        // Extract description from workflow file
+                        const descriptionMatch = content.match(/^#\s*(.+)$/m);
+                        const description = descriptionMatch ? descriptionMatch[1] : 'AL-Go workflow';
+                        // Filter by workflow type if specified
+                        if (workflowType === 'all' || this.matchesWorkflowType(file.name, content, workflowType)) {
+                            workflows.push({
+                                name: file.name,
+                                path: file.path,
+                                content: content,
+                                description: description
+                            });
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Failed to fetch workflow ${file.path}:`, error);
+                        // Continue with other workflows
+                    }
+                }
+            }
+            return workflows;
+        }
+        catch (error) {
+            console.error("Error fetching workflow examples:", error);
+            throw new Error(`Failed to fetch workflow examples: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Check if a workflow matches the specified type
+     */
+    matchesWorkflowType(fileName, content, workflowType) {
+        const lowerFileName = fileName.toLowerCase();
+        const lowerContent = content.toLowerCase();
+        switch (workflowType) {
+            case 'cicd':
+                return lowerFileName.includes('cicd') ||
+                    lowerFileName.includes('ci') ||
+                    lowerContent.includes('continuous integration') ||
+                    lowerContent.includes('build and test');
+            case 'deployment':
+                return lowerFileName.includes('deploy') ||
+                    lowerFileName.includes('release') ||
+                    lowerContent.includes('deployment') ||
+                    lowerContent.includes('publish');
+            case 'testing':
+                return lowerFileName.includes('test') ||
+                    lowerContent.includes('test') ||
+                    lowerContent.includes('validation');
+            default:
+                return true;
+        }
+    }
+}
+//# sourceMappingURL=AlGoService.js.map

package/build/services/AlGoService.js.map

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

package/build/services/DocumentIndex.d.ts

@@ -0,0 +1,48 @@
+import { AlGoService } from "./AlGoService.js";
+export interface SearchResult {
+    title: string;
+    path: string;
+    excerpt: string;
+    score: number;
+    content: string;
+}
+export interface DocumentEntry {
+    path: string;
+    content: string;
+    name: string;
+    title: string;
+    lastIndexed: Date;
+}
+/**
+ * Service for indexing and searching AL-Go documentation
+ */
+export declare class DocumentIndex {
+    private documents;
+    private isInitialized;
+    private lastRefresh;
+    /**
+     * Initialize the document index
+     */
+    initialize(alGoService: AlGoService): Promise<void>;
+    /**
+     * Search through the indexed documents
+     */
+    search(query: string, limit?: number): Promise<SearchResult[]>;
+    /**
+     * Refresh the document index
+     */
+    refresh(alGoService: AlGoService, force?: boolean): Promise<void>;
+    /**
+     * Extract title from document content
+     */
+    private extractTitle;
+    /**
+     * Calculate relevance score for a document given a query
+     */
+    private calculateRelevanceScore;
+    /**
+     * Extract a relevant excerpt from the document content
+     */
+    private extractExcerpt;
+}
+//# sourceMappingURL=DocumentIndex.d.ts.map

package/build/services/DocumentIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentIndex.d.ts","sourceRoot":"","sources":["../../src/services/DocumentIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAqB;IAExC;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BzD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAWxE;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyC/B;;OAEG;IACH,OAAO,CAAC,cAAc;CAmCvB"}

package/build/services/DocumentIndex.js

@@ -0,0 +1,146 @@
+/**
+ * Service for indexing and searching AL-Go documentation
+ */
+export class DocumentIndex {
+    documents = [];
+    isInitialized = false;
+    lastRefresh = null;
+    /**
+     * Initialize the document index
+     */
+    async initialize(alGoService) {
+        if (this.isInitialized && this.lastRefresh &&
+            (Date.now() - this.lastRefresh.getTime()) < 3600000) { // 1 hour cache
+            return;
+        }
+        console.error("Initializing AL-Go document index...");
+        try {
+            const docs = await alGoService.getDocumentationFiles();
+            this.documents = docs.map(doc => ({
+                path: doc.path,
+                content: doc.content,
+                name: doc.name,
+                title: this.extractTitle(doc.content, doc.name),
+                lastIndexed: new Date()
+            }));
+            this.isInitialized = true;
+            this.lastRefresh = new Date();
+            console.error(`Indexed ${this.documents.length} AL-Go documents`);
+        }
+        catch (error) {
+            console.error("Failed to initialize document index:", error);
+            throw error;
+        }
+    }
+    /**
+     * Search through the indexed documents
+     */
+    async search(query, limit = 10) {
+        // Return a simple response to avoid API rate limits
+        return [{
+                title: "AL-Go Documentation Search",
+                path: "README.md",
+                excerpt: `Search for "${query}" - Due to GitHub API rate limits, please use specific file paths with the al-go-doc resource or try the get-al-go-workflows tool.`,
+                score: 1.0,
+                content: "Use specific AL-Go documentation file paths or workflow tools for better results."
+            }];
+    }
+    /**
+     * Refresh the document index
+     */
+    async refresh(alGoService, force = false) {
+        if (force || !this.lastRefresh ||
+            (Date.now() - this.lastRefresh.getTime()) > 3600000) { // 1 hour cache
+            this.isInitialized = false;
+            await this.initialize(alGoService);
+        }
+    }
+    /**
+     * Extract title from document content
+     */
+    extractTitle(content, fallbackName) {
+        // Try to find the first heading in markdown
+        const headingMatch = content.match(/^#\s+(.+)$/m);
+        if (headingMatch) {
+            return headingMatch[1].trim();
+        }
+        // Try to find title in front matter
+        const frontMatterMatch = content.match(/^---\s*\n.*?title:\s*(.+?)\s*\n.*?---/s);
+        if (frontMatterMatch) {
+            return frontMatterMatch[1].trim();
+        }
+        // Use filename without extension as fallback
+        return fallbackName.replace(/\.[^/.]+$/, "");
+    }
+    /**
+     * Calculate relevance score for a document given a query
+     */
+    calculateRelevanceScore(doc, lowerQuery) {
+        let score = 0;
+        const lowerContent = doc.content.toLowerCase();
+        const lowerTitle = doc.title.toLowerCase();
+        const lowerPath = doc.path.toLowerCase();
+        // Exact matches in title get highest score
+        if (lowerTitle.includes(lowerQuery)) {
+            score += 10;
+        }
+        // Matches in path get medium score
+        if (lowerPath.includes(lowerQuery)) {
+            score += 5;
+        }
+        // Word matches in content
+        const queryWords = lowerQuery.split(/\s+/);
+        for (const word of queryWords) {
+            if (word.length > 2) { // Ignore very short words
+                const wordRegex = new RegExp(`\\b${word}\\b`, 'gi');
+                const matches = (lowerContent.match(wordRegex) || []).length;
+                score += matches * 0.5;
+                // Bonus for matches in headings
+                const headingMatches = (lowerContent.match(new RegExp(`^#+.*${word}.*$`, 'gmi')) || []).length;
+                score += headingMatches * 2;
+            }
+        }
+        // Bonus for AL-Go specific terms
+        const alGoTerms = ['al-go', 'business central', 'workflow', 'actions', 'templates', 'devops'];
+        for (const term of alGoTerms) {
+            if (lowerQuery.includes(term) && lowerContent.includes(term)) {
+                score += 1;
+            }
+        }
+        return score;
+    }
+    /**
+     * Extract a relevant excerpt from the document content
+     */
+    extractExcerpt(content, lowerQuery, maxLength = 200) {
+        const lowerContent = content.toLowerCase();
+        const queryWords = lowerQuery.split(/\s+/);
+        // Find the first occurrence of any query word
+        let bestIndex = -1;
+        for (const word of queryWords) {
+            if (word.length > 2) {
+                const index = lowerContent.indexOf(word);
+                if (index !== -1 && (bestIndex === -1 || index < bestIndex)) {
+                    bestIndex = index;
+                }
+            }
+        }
+        if (bestIndex === -1) {
+            // No match found, return beginning of content
+            return content.substring(0, maxLength).trim() + (content.length > maxLength ? '...' : '');
+        }
+        // Extract excerpt around the match
+        const start = Math.max(0, bestIndex - 50);
+        const end = Math.min(content.length, start + maxLength);
+        let excerpt = content.substring(start, end);
+        // Clean up the excerpt
+        excerpt = excerpt.replace(/\n+/g, ' ').trim();
+        // Add ellipsis if we're not at the beginning/end
+        if (start > 0)
+            excerpt = '...' + excerpt;
+        if (end < content.length)
+            excerpt = excerpt + '...';
+        return excerpt;
+    }
+}
+//# sourceMappingURL=DocumentIndex.js.map

package/build/services/DocumentIndex.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "al-go-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for AL-Go documentation integration",
+  "type": "module",
+  "main": "./build/index.js",
+  "bin": {
+    "al-go-mcp-server": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc && node build/index.js",
+    "watch": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "al-go",
+    "documentation",
+    "github"
+  ],
+  "author": "Job Louage",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "@octokit/rest": "^21.0.2",
+    "zod": "^3.23.8",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "files": [
+    "build"
+  ]
+}