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

# 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):

{
  "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

{
  "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):

{
  "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:

{
  "skills": ["typescript-best-practices", "react-patterns", "testing-guidelines"]
}

get_skill

Returns the content of a specific skill.

Input:

{
  "skill_name": "typescript-best-practices"
}

Output: The markdown content of the skill file.

Development

# Build
npm run build

# Watch mode
npm run dev

# Run the server
npm start

License

ISC