my-personal-code-mcp 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh issue create:*)",
+      "mcp__github__get_me",
+      "Bash(git remote:*)",
+      "mcp__github__issue_write",
+      "Bash(npm init:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run build:*)",
+      "Bash(set SKILLS_REPO_OWNER=lfdantoni)",
+      "Bash(set SKILLS_REPO_NAME=my-skills-repo:*)",
+      "Bash(set SKILLS_PATH=skills)",
+      "Bash(npx tsx:*)",
+      "Bash($env:SKILLS_REPO_OWNER=\"lfdantoni\")",
+      "Bash($env:SKILLS_REPO_NAME=\"my-skills-repo\")",
+      "Bash($env:SKILLS_PATH=\"skills\")",
+      "Bash(export SKILLS_REPO_OWNER=lfdantoni)",
+      "Bash(export SKILLS_REPO_NAME=my-skills-repo)",
+      "Bash(export SKILLS_PATH=skills)",
+      "mcp__github__get_file_contents",
+      "Bash(git add:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nImplement MCP server for skills from GitHub repository\n\n- Add MCP server with stdio transport using @modelcontextprotocol/sdk\n- Implement list_skills tool to fetch skill names from GitHub repo\n- Implement get_skill tool to retrieve skill content by name\n- Add GitHubService with error handling for API calls\n- Configure TypeScript build with ES modules\n- Add documentation with Cursor, Claude Desktop, and CLI examples\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")"
+    ]
+  }
+}

package/README.md

@@ -0,0 +1,166 @@
+# my-personal-code-mcp
+
+An MCP (Model Context Protocol) server that provides AI assistants with access to best practice skills stored as markdown files in a GitHub repository.
+
+## Features
+
+- **list_skills**: Returns a list of all available skill names from the configured repository
+- **get_skill**: Retrieves the content of a specific skill by name
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/lfdantoni/my-personal-code-mcp.git
+cd my-personal-code-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `SKILLS_REPO_OWNER` | GitHub repository owner (username or organization) | Yes |
+| `SKILLS_REPO_NAME` | GitHub repository name | Yes |
+| `SKILLS_PATH` | Subdirectory containing skill files (default: root) | No |
+| `GITHUB_TOKEN` | GitHub personal access token (required for private repos) | No |
+
+### Skills Repository Structure
+
+Your skills repository should contain markdown files (`.md`) with best practices:
+
+```
+your-skills-repo/
+├── typescript-best-practices.md
+├── react-patterns.md
+├── testing-guidelines.md
+└── ...
+```
+
+Or with a subdirectory:
+
+```
+your-skills-repo/
+└── skills/
+    ├── typescript-best-practices.md
+    ├── react-patterns.md
+    └── ...
+```
+
+## MCP Client Configuration
+
+### Cursor
+
+Add the following to your Cursor MCP settings file (`~/.cursor/mcp.json` or via Settings > MCP):
+
+```json
+{
+  "mcpServers": {
+    "my-personal-code-mcp": {
+      "command": "node",
+      "args": ["C:/path/to/my-personal-code-mcp/dist/index.js"],
+      "env": {
+        "SKILLS_REPO_OWNER": "your-github-username",
+        "SKILLS_REPO_NAME": "your-skills-repo",
+        "SKILLS_PATH": "",
+        "GITHUB_TOKEN": "ghp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add the following to your Claude Desktop configuration file:
+
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "my-personal-code-mcp": {
+      "command": "node",
+      "args": ["C:/path/to/my-personal-code-mcp/dist/index.js"],
+      "env": {
+        "SKILLS_REPO_OWNER": "your-github-username",
+        "SKILLS_REPO_NAME": "your-skills-repo",
+        "SKILLS_PATH": "",
+        "GITHUB_TOKEN": "ghp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code CLI
+
+Add to your Claude Code settings (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "my-personal-code-mcp": {
+      "command": "node",
+      "args": ["/path/to/my-personal-code-mcp/dist/index.js"],
+      "env": {
+        "SKILLS_REPO_OWNER": "your-github-username",
+        "SKILLS_REPO_NAME": "your-skills-repo"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### list_skills
+
+Returns a list of all available skill names.
+
+**Input**: None
+
+**Output**:
+```json
+{
+  "skills": ["typescript-best-practices", "react-patterns", "testing-guidelines"]
+}
+```
+
+### get_skill
+
+Returns the content of a specific skill.
+
+**Input**:
+```json
+{
+  "skill_name": "typescript-best-practices"
+}
+```
+
+**Output**: The markdown content of the skill file.
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run the server
+npm start
+```
+
+## License
+
+ISC

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,62 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { GitHubService } from "./services/github.js";
+import { handleListSkills, getSkillSchema, handleGetSkill, } from "./tools/index.js";
+const server = new McpServer({
+    name: "my-personal-code-mcp",
+    version: "1.0.0",
+    description: "MCP server for AI best practices skills from GitHub repository",
+});
+let githubService;
+try {
+    githubService = new GitHubService();
+}
+catch (error) {
+    console.error("Failed to initialize GitHub service:", error);
+    process.exit(1);
+}
+server.registerTool("list_skills", {
+    description: "Returns a list of all available best practice skills",
+}, async () => {
+    try {
+        const result = await handleListSkills(githubService);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+server.registerTool("get_skill", {
+    description: "Returns the content of a specific best practice skill",
+    inputSchema: getSkillSchema,
+}, async (input) => {
+    try {
+        const result = await handleGetSkill(githubService, input);
+        return {
+            content: [{ type: "text", text: result.content }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server 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":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,gEAAgE;CAC9E,CAAC,CAAC;AAEH,IAAI,aAA4B,CAAC;AAEjC,IAAI,CAAC;IACH,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AACtC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;IACE,WAAW,EAAE,sDAAsD;CACpE,EACD,KAAK,IAAI,EAAE;IACT,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YACtD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;IACE,WAAW,EAAE,uDAAuD;IACpE,WAAW,EAAE,cAAc;CAC5B,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;IACd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;SAClD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YACtD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/services/github.d.ts

@@ -0,0 +1,19 @@
+export interface SkillFile {
+    name: string;
+    path: string;
+}
+export declare class GitHubServiceError extends Error {
+    readonly code: "NOT_FOUND" | "RATE_LIMIT" | "AUTH_ERROR" | "UNKNOWN";
+    constructor(message: string, code: "NOT_FOUND" | "RATE_LIMIT" | "AUTH_ERROR" | "UNKNOWN");
+}
+export declare class GitHubService {
+    private octokit;
+    private owner;
+    private repo;
+    private skillsPath;
+    constructor();
+    listSkillFiles(): Promise<SkillFile[]>;
+    getSkillContent(skillName: string): Promise<string>;
+    private handleError;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/services/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/services/github.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS;gBAD3E,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS;CAK9E;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAS;;IAiBrB,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA0BtC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmCzD,OAAO,CAAC,WAAW;CA0CpB"}

package/dist/services/github.js

@@ -0,0 +1,92 @@
+import { Octokit } from "octokit";
+export class GitHubServiceError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "GitHubServiceError";
+    }
+}
+export class GitHubService {
+    octokit;
+    owner;
+    repo;
+    skillsPath;
+    constructor() {
+        const token = process.env.GITHUB_TOKEN;
+        this.owner = process.env.SKILLS_REPO_OWNER || "";
+        this.repo = process.env.SKILLS_REPO_NAME || "";
+        this.skillsPath = process.env.SKILLS_PATH || "";
+        if (!this.owner || !this.repo) {
+            throw new Error("SKILLS_REPO_OWNER and SKILLS_REPO_NAME environment variables are required");
+        }
+        this.octokit = new Octokit({ auth: token });
+    }
+    async listSkillFiles() {
+        try {
+            const response = await this.octokit.rest.repos.getContent({
+                owner: this.owner,
+                repo: this.repo,
+                path: this.skillsPath,
+            });
+            if (!Array.isArray(response.data)) {
+                throw new GitHubServiceError("Expected directory but found file", "UNKNOWN");
+            }
+            return response.data
+                .filter((item) => item.type === "file" && item.name.endsWith(".md"))
+                .map((item) => ({
+                name: item.name.replace(/\.md$/, ""),
+                path: item.path,
+            }));
+        }
+        catch (error) {
+            throw this.handleError(error, "listing skills");
+        }
+    }
+    async getSkillContent(skillName) {
+        const filePath = this.skillsPath
+            ? `${this.skillsPath}/${skillName}.md`
+            : `${skillName}.md`;
+        try {
+            const response = await this.octokit.rest.repos.getContent({
+                owner: this.owner,
+                repo: this.repo,
+                path: filePath,
+            });
+            if (Array.isArray(response.data)) {
+                throw new GitHubServiceError(`"${skillName}" is a directory, not a skill file`, "NOT_FOUND");
+            }
+            if (response.data.type !== "file" || !("content" in response.data)) {
+                throw new GitHubServiceError(`"${skillName}" is not a valid skill file`, "NOT_FOUND");
+            }
+            const content = Buffer.from(response.data.content, "base64").toString("utf-8");
+            return content;
+        }
+        catch (error) {
+            throw this.handleError(error, `fetching skill "${skillName}"`);
+        }
+    }
+    handleError(error, context) {
+        if (error instanceof GitHubServiceError) {
+            return error;
+        }
+        if (error && typeof error === "object" && "status" in error) {
+            const status = error.status;
+            switch (status) {
+                case 404:
+                    return new GitHubServiceError(`Resource not found while ${context}`, "NOT_FOUND");
+                case 403:
+                    const message = "message" in error ? String(error.message) : "Rate limit exceeded";
+                    if (message.toLowerCase().includes("rate limit")) {
+                        return new GitHubServiceError(`GitHub API rate limit exceeded while ${context}`, "RATE_LIMIT");
+                    }
+                    return new GitHubServiceError(`Access forbidden while ${context}. Check GITHUB_TOKEN.`, "AUTH_ERROR");
+                case 401:
+                    return new GitHubServiceError(`Authentication failed while ${context}. Check GITHUB_TOKEN.`, "AUTH_ERROR");
+            }
+        }
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        return new GitHubServiceError(`Error ${context}: ${errorMessage}`, "UNKNOWN");
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/services/github.js.map

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

package/dist/tools/get-skill.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { GitHubService } from "../services/github.js";
+export declare const getSkillSchema: {
+    skill_name: z.ZodString;
+};
+export interface GetSkillInput {
+    skill_name: string;
+}
+export interface GetSkillResult {
+    skill_name: string;
+    content: string;
+}
+export declare function handleGetSkill(githubService: GitHubService, input: GetSkillInput): Promise<GetSkillResult>;
+//# sourceMappingURL=get-skill.d.ts.map

package/dist/tools/get-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-skill.d.ts","sourceRoot":"","sources":["../../src/tools/get-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAsB,MAAM,uBAAuB,CAAC;AAE1E,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,CAAC,CA2BzB"}

package/dist/tools/get-skill.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { GitHubServiceError } from "../services/github.js";
+export const getSkillSchema = {
+    skill_name: z.string().describe("The name of the skill to retrieve"),
+};
+export async function handleGetSkill(githubService, input) {
+    const { skill_name } = input;
+    if (!skill_name || typeof skill_name !== "string") {
+        throw new Error("skill_name is required and must be a string");
+    }
+    const trimmedName = skill_name.trim();
+    if (trimmedName.length === 0) {
+        throw new Error("skill_name cannot be empty");
+    }
+    try {
+        const content = await githubService.getSkillContent(trimmedName);
+        return {
+            skill_name: trimmedName,
+            content,
+        };
+    }
+    catch (error) {
+        if (error instanceof GitHubServiceError) {
+            if (error.code === "NOT_FOUND") {
+                throw new Error(`Skill "${trimmedName}" not found`);
+            }
+            throw new Error(`Failed to get skill: ${error.message}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=get-skill.js.map

package/dist/tools/get-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-skill.js","sourceRoot":"","sources":["../../src/tools/get-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CACrE,CAAC;AAWF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,aAA4B,EAC5B,KAAoB;IAEpB,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAE7B,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACjE,OAAO;YACL,UAAU,EAAE,WAAW;YACvB,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,UAAU,WAAW,aAAa,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { listSkillsSchema, handleListSkills, type ListSkillsResult, } from "./list-skills.js";
+export { getSkillSchema, handleGetSkill, type GetSkillInput, type GetSkillResult, } from "./get-skill.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { listSkillsSchema, handleListSkills, } from "./list-skills.js";
+export { getSkillSchema, handleGetSkill, } from "./get-skill.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,cAAc,GAGf,MAAM,gBAAgB,CAAC"}

package/dist/tools/list-skills.d.ts

@@ -0,0 +1,7 @@
+import { GitHubService } from "../services/github.js";
+export declare const listSkillsSchema: {};
+export interface ListSkillsResult {
+    skills: string[];
+}
+export declare function handleListSkills(githubService: GitHubService): Promise<ListSkillsResult>;
+//# sourceMappingURL=list-skills.d.ts.map

package/dist/tools/list-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-skills.d.ts","sourceRoot":"","sources":["../../src/tools/list-skills.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAsB,MAAM,uBAAuB,CAAC;AAE1E,eAAO,MAAM,gBAAgB,IAAK,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/tools/list-skills.js

@@ -0,0 +1,16 @@
+import { GitHubServiceError } from "../services/github.js";
+export const listSkillsSchema = {};
+export async function handleListSkills(githubService) {
+    try {
+        const files = await githubService.listSkillFiles();
+        const skills = files.map((file) => file.name);
+        return { skills };
+    }
+    catch (error) {
+        if (error instanceof GitHubServiceError) {
+            throw new Error(`Failed to list skills: ${error.message}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=list-skills.js.map

package/dist/tools/list-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-skills.js","sourceRoot":"","sources":["../../src/tools/list-skills.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAMnC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "my-personal-code-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AI best practices skills",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "my-personal-code-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lfdantoni/my-personal-code-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "skills"
+  ],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/lfdantoni/my-personal-code-mcp/issues"
+  },
+  "homepage": "https://github.com/lfdantoni/my-personal-code-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "octokit": "^5.0.5",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.6",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { GitHubService } from "./services/github.js";
+import {
+  handleListSkills,
+  getSkillSchema,
+  handleGetSkill,
+} from "./tools/index.js";
+
+const server = new McpServer({
+  name: "my-personal-code-mcp",
+  version: "1.0.0",
+  description: "MCP server for AI best practices skills from GitHub repository",
+});
+
+let githubService: GitHubService;
+
+try {
+  githubService = new GitHubService();
+} catch (error) {
+  console.error("Failed to initialize GitHub service:", error);
+  process.exit(1);
+}
+
+server.registerTool(
+  "list_skills",
+  {
+    description: "Returns a list of all available best practice skills",
+  },
+  async () => {
+    try {
+      const result = await handleListSkills(githubService);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "get_skill",
+  {
+    description: "Returns the content of a specific best practice skill",
+    inputSchema: getSkillSchema,
+  },
+  async (input) => {
+    try {
+      const result = await handleGetSkill(githubService, input);
+      return {
+        content: [{ type: "text", text: result.content }],
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+      };
+    }
+  }
+);
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/src/services/github.ts

@@ -0,0 +1,142 @@
+import { Octokit } from "octokit";
+
+export interface SkillFile {
+  name: string;
+  path: string;
+}
+
+export class GitHubServiceError extends Error {
+  constructor(
+    message: string,
+    public readonly code: "NOT_FOUND" | "RATE_LIMIT" | "AUTH_ERROR" | "UNKNOWN"
+  ) {
+    super(message);
+    this.name = "GitHubServiceError";
+  }
+}
+
+export class GitHubService {
+  private octokit: Octokit;
+  private owner: string;
+  private repo: string;
+  private skillsPath: string;
+
+  constructor() {
+    const token = process.env.GITHUB_TOKEN;
+    this.owner = process.env.SKILLS_REPO_OWNER || "";
+    this.repo = process.env.SKILLS_REPO_NAME || "";
+    this.skillsPath = process.env.SKILLS_PATH || "";
+
+    if (!this.owner || !this.repo) {
+      throw new Error(
+        "SKILLS_REPO_OWNER and SKILLS_REPO_NAME environment variables are required"
+      );
+    }
+
+    this.octokit = new Octokit({ auth: token });
+  }
+
+  async listSkillFiles(): Promise<SkillFile[]> {
+    try {
+      const response = await this.octokit.rest.repos.getContent({
+        owner: this.owner,
+        repo: this.repo,
+        path: this.skillsPath,
+      });
+
+      if (!Array.isArray(response.data)) {
+        throw new GitHubServiceError(
+          "Expected directory but found file",
+          "UNKNOWN"
+        );
+      }
+
+      return response.data
+        .filter((item) => item.type === "file" && item.name.endsWith(".md"))
+        .map((item) => ({
+          name: item.name.replace(/\.md$/, ""),
+          path: item.path,
+        }));
+    } catch (error) {
+      throw this.handleError(error, "listing skills");
+    }
+  }
+
+  async getSkillContent(skillName: string): Promise<string> {
+    const filePath = this.skillsPath
+      ? `${this.skillsPath}/${skillName}.md`
+      : `${skillName}.md`;
+
+    try {
+      const response = await this.octokit.rest.repos.getContent({
+        owner: this.owner,
+        repo: this.repo,
+        path: filePath,
+      });
+
+      if (Array.isArray(response.data)) {
+        throw new GitHubServiceError(
+          `"${skillName}" is a directory, not a skill file`,
+          "NOT_FOUND"
+        );
+      }
+
+      if (response.data.type !== "file" || !("content" in response.data)) {
+        throw new GitHubServiceError(
+          `"${skillName}" is not a valid skill file`,
+          "NOT_FOUND"
+        );
+      }
+
+      const content = Buffer.from(response.data.content, "base64").toString(
+        "utf-8"
+      );
+      return content;
+    } catch (error) {
+      throw this.handleError(error, `fetching skill "${skillName}"`);
+    }
+  }
+
+  private handleError(error: unknown, context: string): GitHubServiceError {
+    if (error instanceof GitHubServiceError) {
+      return error;
+    }
+
+    if (error && typeof error === "object" && "status" in error) {
+      const status = (error as { status: number }).status;
+
+      switch (status) {
+        case 404:
+          return new GitHubServiceError(
+            `Resource not found while ${context}`,
+            "NOT_FOUND"
+          );
+        case 403:
+          const message =
+            "message" in error ? String(error.message) : "Rate limit exceeded";
+          if (message.toLowerCase().includes("rate limit")) {
+            return new GitHubServiceError(
+              `GitHub API rate limit exceeded while ${context}`,
+              "RATE_LIMIT"
+            );
+          }
+          return new GitHubServiceError(
+            `Access forbidden while ${context}. Check GITHUB_TOKEN.`,
+            "AUTH_ERROR"
+          );
+        case 401:
+          return new GitHubServiceError(
+            `Authentication failed while ${context}. Check GITHUB_TOKEN.`,
+            "AUTH_ERROR"
+          );
+      }
+    }
+
+    const errorMessage =
+      error instanceof Error ? error.message : "Unknown error";
+    return new GitHubServiceError(
+      `Error ${context}: ${errorMessage}`,
+      "UNKNOWN"
+    );
+  }
+}

package/src/tools/get-skill.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { GitHubService, GitHubServiceError } from "../services/github.js";
+
+export const getSkillSchema = {
+  skill_name: z.string().describe("The name of the skill to retrieve"),
+};
+
+export interface GetSkillInput {
+  skill_name: string;
+}
+
+export interface GetSkillResult {
+  skill_name: string;
+  content: string;
+}
+
+export async function handleGetSkill(
+  githubService: GitHubService,
+  input: GetSkillInput
+): Promise<GetSkillResult> {
+  const { skill_name } = input;
+
+  if (!skill_name || typeof skill_name !== "string") {
+    throw new Error("skill_name is required and must be a string");
+  }
+
+  const trimmedName = skill_name.trim();
+  if (trimmedName.length === 0) {
+    throw new Error("skill_name cannot be empty");
+  }
+
+  try {
+    const content = await githubService.getSkillContent(trimmedName);
+    return {
+      skill_name: trimmedName,
+      content,
+    };
+  } catch (error) {
+    if (error instanceof GitHubServiceError) {
+      if (error.code === "NOT_FOUND") {
+        throw new Error(`Skill "${trimmedName}" not found`);
+      }
+      throw new Error(`Failed to get skill: ${error.message}`);
+    }
+    throw error;
+  }
+}

package/src/tools/index.ts

@@ -0,0 +1,12 @@
+export {
+  listSkillsSchema,
+  handleListSkills,
+  type ListSkillsResult,
+} from "./list-skills.js";
+
+export {
+  getSkillSchema,
+  handleGetSkill,
+  type GetSkillInput,
+  type GetSkillResult,
+} from "./get-skill.js";

package/src/tools/list-skills.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { GitHubService, GitHubServiceError } from "../services/github.js";
+
+export const listSkillsSchema = {};
+
+export interface ListSkillsResult {
+  skills: string[];
+}
+
+export async function handleListSkills(
+  githubService: GitHubService
+): Promise<ListSkillsResult> {
+  try {
+    const files = await githubService.listSkillFiles();
+    const skills = files.map((file) => file.name);
+    return { skills };
+  } catch (error) {
+    if (error instanceof GitHubServiceError) {
+      throw new Error(`Failed to list skills: ${error.message}`);
+    }
+    throw error;
+  }
+}

package/tsconfig.json

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