# 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
