Retrieves and lists best practice skills stored as markdown files in a GitHub repository, supporting both public and private repositories via personal access tokens.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Personal Code Skills MCP Servershow me my React patterns guidelines"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfiguration
Environment Variables
Variable | Description | Required |
| GitHub repository owner (username or organization) | Yes |
| GitHub repository name | Yes |
| Subdirectory containing skill files (default: root) | No |
| 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 startLicense
ISC