paladini/mcp-me

**Your AI assistants don't know who you are.** Every time you start a conversation with Claude, Copilot, Cursor, or Windsurf, it's a blank slate — no context about your skills, your projects, your career, or what you care about.
**mcp-me fixes that.** It creates a structured personal profile that any AI assistant can read via the Model Context Protocol (MCP). Think of it as a **digital identity layer for AI** — your bio, career, skills, interests, projects, and more, always available to every AI tool you use.
Why mcp-me?
- **AI that knows you** — Your assistants remember your skills, career, projects, and personality across every conversation
- **Auto-generated** — Pull data from 329 registered generators (implemented across 44 generator source files) with one command
- **Privacy-first** — All data stays local in YAML files on your machine. Nothing is sent to any cloud.
- **Real-time plugins** — 13 live integrations (Spotify now playing, GitHub repos, Last.fm scrobbles) that AI queries on demand
- **Extensible** — Community-driven generators and plugins. Add a new data source in ~10 lines of code.
- **Works everywhere** — Claude Desktop, Cursor, Windsurf, Copilot, and any MCP-compatible AI assistant
Installation
> **Prerequisite:** Node.js 20 or later. Verify with node -v.
One-Click Install
Add mcp-me to your AI assistant in one click — no path configuration needed (profile defaults to ~/.mcp-me):
  
**Claude Desktop:** Download the latest .mcpb release and double-click to install, or drag it into Claude Desktop → Settings → Extensions.
After installing, initialize your profile:
npm (recommended)
This makes the mcp-me command available everywhere on your system. No need to clone any repository — npm downloads the package for you.
**Alternative — run without installing** (via npx):
npx downloads the package temporarily and runs it. Useful for trying mcp-me once, but slower on repeated use since it re-downloads each time.
> **Profile location:** Commands default to ~/.mcp-me. Override with MCP_ME_PROFILE_DIR or pass an explicit path: mcp-me serve ~/my-profile.
Quick Start
Your .mcp-me.yaml config file:
> **CLI flags also work:** mcp-me generate --github octocat --devto myuser
All commands work with npx (zero install) or with mcp-me directly if installed globally. The generate command pulls your data from public APIs and auto-populates profile YAML files — no API keys needed for most sources.
Profile directory structure
Configure Your AI Assistant
One-Click (Cursor & VS Code)
Use the one-click install badges above. After installing, run mcp-me init to create your profile.
Cursor Plugin (Open Plugins)
mcp-me ships as a full Open Plugins plugin for Cursor. Install from cursor.directory or clone the repo — the plugin auto-detects all components:
| Component | Location | Purpose |
|---|---|---|
| MCP Server | mcp.json | Zero-config npx -y mcp-me serve |
| Rules | rules/ | Always consult profile before answering |
| Skills | skills/ | Profile usage and setup guides |
| Agents | agents/ | Profile assistant and intro writer |
| Commands | commands/ | /ask-about-me and /introduce-me |
| Hooks | hooks/hooks.json | Session-start profile reminder |
| LSP | .lsp.json | YAML language server for profile files |
Validate the plugin structure: npm run validate:open-plugin
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
Cursor (manual)
Add to .cursor/mcp.json in your project root:
VS Code (GitHub Copilot)
Add to .vscode/mcp.json in your project root (or in your User Settings for global access):
> **Tip:** To enable it globally (all workspaces), open VS Code Settings (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") and add the mcp key there instead.
Claude Desktop
**Option A — Desktop Extension (.mcpb, recommended):**
1. Download mcp-me.mcpb from GitHub Releases
2. Double-click the file, or drag it into Claude Desktop → Settings → Extensions
3. Set your profile directory when prompted (default: ~/.mcp-me)