mcp-me

mcp-me

Tus asistentes de IA no saben quién eres. Cada vez que inicias una conversación con Claude, Copilot, Cursor o Windsurf, es una pizarra en blanco — sin contexto sobre tus habilidades, tus proyectos, tu carrera o lo que te importa.

mcp-me soluciona eso. Crea un perfil personal estructurado que cualquier asistente de IA puede leer mediante el Protocolo de Contexto de Modelo (MCP). Piénsalo como una capa de identidad digital para la IA — tu biografía, carrera, habilidades, intereses, proyectos y más, siempre disponibles para cada herramienta de IA que uses.

You: "Write me a cover letter for this job"
AI:  (reads your me://career, me://skills, me://projects)
     "Based on your 5 years at Acme Corp, your TypeScript expertise,
      and your open-source work on mcp-me..."

¿Por qué mcp-me?

• IA que te conoce — Tus asistentes recuerdan tus habilidades, carrera, proyectos y personalidad en cada conversación
• Generación automática — Obtén datos de 329 generadores registrados (implementados en 44 archivos fuente de generadores) con un solo comando
• Privacidad primero — Todos los datos permanecen localmente en archivos YAML en tu máquina. Nada se envía a la nube.
• Plugins en tiempo real — 13 integraciones en vivo (Spotify reproduciendo ahora, repositorios de GitHub, scrobbles de Last.fm) que la IA consulta bajo demanda
• Extensible — Generadores y plugins impulsados por la comunidad. Añade una nueva fuente de datos en ~10 líneas de código.
• Funciona en todas partes — Claude Desktop, Cursor, Windsurf, Copilot y cualquier asistente de IA compatible con MCP

Instalación

Requisito previo: Node.js 20 o posterior. Verifica con node -v.

Instalación con un clic

Añade mcp-me a tu asistente de IA con un clic — sin necesidad de configurar rutas (el perfil se establece por defecto en ~/.mcp-me):

  

Claude Desktop: Descarga la última versión de .mcpb y haz doble clic para instalarla, o arrástrala a Claude Desktop → Configuración → Extensiones.

Después de instalar, inicializa tu perfil:

mcp-me init
mcp-me generate --github your-username

npm (recomendado)

npm install -g mcp-me

Esto hace que el comando mcp-me esté disponible en todo tu sistema. No necesitas clonar ningún repositorio — npm descarga el paquete por ti.

mcp-me --help
mcp-me init
mcp-me generate --github your-username
mcp-me serve

Alternativa — ejecutar sin instalar (mediante npx):

npx mcp-me --help

npx descarga el paquete temporalmente y lo ejecuta. Útil para probar mcp-me una vez, pero más lento en uso repetido porque lo vuelve a descargar cada vez.

Ubicación del perfil: Los comandos usan por defecto ~/.mcp-me. Sobrescribe con MCP_ME_PROFILE_DIR o pasa una ruta explícita: mcp-me serve ~/my-profile.

Inicio rápido

# 1. Initialize your profile (creates YAML templates + .mcp-me.yaml in ~/.mcp-me)
mcp-me init

# 2. Edit the config file — uncomment your sources
code ~/.mcp-me/.mcp-me.yaml

Tu archivo de configuración .mcp-me.yaml:

generators:
  github: your-username
  devto: your-username
  bluesky: handle.bsky.social
  zodiac: aquarius

plugins:
  github:
    enabled: true
    username: your-username

# 3. Generate! Reads sources from .mcp-me.yaml automatically
mcp-me generate

# 4. Start the MCP server
mcp-me serve

Las banderas de CLI también funcionan: mcp-me generate --github octocat --devto myuser

Todos los comandos funcionan con npx (instalación cero) o con mcp-me directamente si está instalado globalmente. El comando generate extrae tus datos de APIs públicas y completa automáticamente los archivos YAML del perfil — sin necesidad de claves API para la mayoría de las fuentes.

Estructura del directorio de perfil

~/.mcp-me/             → Default profile location
  .mcp-me.yaml        → Configuration (generators + plugins)
  identity.yaml        → Your data (name, bio, contact)
  skills.yaml          → Your data (languages, tools)
  projects.yaml        → Your data (portfolio)
  career.yaml          → Your data (experience)
  interests.yaml       → Your data (hobbies, topics)
  personality.yaml     → Your data (traits, values)
  goals.yaml           → Your data (short/long-term)
  faq.yaml             → Your data (Q&A pairs)

Configura tu asistente de IA

Un clic (Cursor y VS Code)

Usa las insignias de instalación con un clic de arriba. Después de instalar, ejecuta mcp-me init para crear tu perfil.

Plugin de Cursor (Open Plugins)

mcp-me se distribuye como un plugin completo de Open Plugins para Cursor. Instálalo desde cursor.directory o clona el repositorio — el plugin detecta automáticamente todos los componentes:

Componente	Ubicación	Propósito
Servidor MCP	mcp.json	npx -y mcp-me serve sin configuración
Reglas	rules/	Consultar siempre el perfil antes de responder
Habilidades	skills/	Guías de uso y configuración del perfil
Agentes	agents/	Asistente de perfil y redactor de introducción
Comandos	commands/	/ask-about-me y /introduce-me
Hooks	hooks/hooks.json	Recordatorio de perfil al inicio de sesión
LSP	.lsp.json	Servidor de lenguaje YAML para archivos de perfil

Valida la estructura del plugin: npm run validate:open-plugin

Windsurf

Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "me": {
      "command": "npx",
      "args": ["-y", "mcp-me", "serve"]
    }
  }
}

Cursor (manual)

Añade a .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "me": {
      "command": "npx",
      "args": ["-y", "mcp-me", "serve"]
    }
  }
}

VS Code (GitHub Copilot)

Añade a .vscode/mcp.json en la raíz de tu proyecto (o en tu Configuración de Usuario para acceso global):

{
  "servers": {
    "me": {
      "command": "npx",
      "args": ["-y", "mcp-me", "serve"]
    }
  }
}

Consejo: Para habilitarlo globalmente (todos los espacios de trabajo), abre la Configuración de VS Code (Ctrl+Shift+P → "Preferencias: Abrir Configuración de Usuario (JSON)") y añade la clave mcp allí en su lugar.

Claude Desktop

Opción A — Extensión de escritorio (.mcpb, recomendada):

1. Descarga mcp-me.mcpb desde GitHub Releases
2. Haz doble clic en el archivo, o arrástralo a Claude Desktop → Configuración → Extensiones
3. Establece tu directorio de perfil cuando se te solicite (por defecto: ~/.mcp-me)
4. Ejecuta mcp-me init si aún no has creado un perfil

Opción B — Configuración manual:

Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "me": {
      "command": "npx",
      "args": ["-y", "mcp-me", "serve"]
    }
  }
}

Archivos de instrucciones para agentes

Los agentes de IA leen archivos Markdown especiales en tu proyecto para entender cómo deben comportarse. Combínalos con mcp-me para que cada sesión de IA consulte automáticamente tu perfil — sin repetir tu stack, carrera o preferencias en cada conversación.

Archivo	Funciona con
AGENTS.md (raíz del proyecto)	Windsurf (Cascade), OpenAI Codex, Cline y otros
.github/copilot-instructions.md	GitHub Copilot (VS Code + GitHub.com)

Configuración rápida:

# AGENTS.md — for Windsurf, Cline, Codex, etc.
cp "$(npm root -g)/mcp-me/templates/AGENTS.md" ./AGENTS.md

# GitHub Copilot
mkdir -p .github
cp "$(npm root -g)/mcp-me/templates/.github/copilot-instructions.md" .github/copilot-instructions.md

Ambas plantillas se incluyen con mcp-me y le indican a la IA que llame a ask_about_me cada vez que el contexto sobre ti mejore la respuesta.

Consulta la Guía de instrucciones para agentes para ver ejemplos, configuración global y consejos para combinar con reglas específicas del proyecto.

Esquema del perfil

Tu perfil es una colección de archivos YAML:

Archivo	Descripción
identity.yaml	Nombre, biografía, ubicación, idiomas, información de contacto
career.yaml	Experiencia laboral, educación, certificaciones
skills.yaml	Habilidades técnicas y blandas con niveles de competencia
interests.yaml	Pasatiempos, música, libros, películas, preferencias alimentarias
personality.yaml	Valores, rasgos, MBTI, fortalezas
goals.yaml	Metas a corto, mediano y largo plazo
projects.yaml	Proyectos personales y de código abierto
faq.yaml	Pares de preguntas y respuestas personalizados sobre ti

Consulta la Referencia del esquema para documentación completa.

Interfaz MCP

Recursos

Datos de perfil estáticos expuestos como recursos MCP:

• me://identity — Identidad personal y contacto
• me://career — Historial profesional
• me://skills — Habilidades y competencias
• me://interests — Pasatiempos y preferencias
• me://personality — Rasgos de personalidad y valores
• me://goals — Metas personales y profesionales
• me://projects — Portafolio y proyectos
• me://faq — Preguntas frecuentes

Herramientas

• ask_about_me — Pregunta de formato libre sobre el usuario
• search_profile — Búsqueda por palabras clave en todos los datos del perfil

Prompts

• introduce_me — Genera una introducción de 2 párrafos
• summarize_career — Resume la trayectoria profesional
• technical_profile — Describe habilidades técnicas y stack
• collaboration_fit — Evalúa la idoneidad para un proyecto

Generadores (ejemplos seleccionados)

Los generadores se ejecutan durante mcp-me generate para completar automáticamente tu perfil desde APIs públicas o exportaciones proporcionadas por el usuario. No se necesitan claves API para la mayoría de las fuentes.

Conteos actuales:

• Generadores registrados: 329
• Archivos fuente de generadores: 44 archivos de un solo generador + 15 archivos por lotes (src/generators/)

La tabla siguiente es una lista seleccionada de generadores de uso común. La fuente completa de verdad es src/generators/index.ts.

Categoría	Bandera	Fuente	Datos
Código	--github <user>	API de GitHub	Repos, lenguajes, estrellas, perfil
Código	--gitlab <user>	API de GitLab	Proyectos, temas, perfil
Código	--bitbucket <user>	API de Bitbucket	Repos, lenguajes
Código	--huggingface <user>	API de Hugging Face	Modelos, conjuntos de datos, espacios
Código	--kaggle <user>	API de Kaggle	Competiciones, conjuntos de datos, medallas
Código	--codeberg <user>	API de Gitea	Repos, lenguajes
Escritura	--devto <user>	API de DEV.to	Artículos, etiquetas, reacciones
Escritura	--medium <user>	RSS de Medium	Artículos, categorías, texto de artículos
Escritura	--blogger-backup <xml>	Exportación XML de Blogger	Publicaciones importadas desde una copia de seguridad local, filtradas por autor si es necesario
Escritura	--hashnode <user>	GraphQL de Hashnode	Publicaciones de blog, etiquetas
Escritura	--substack <user>	RSS de Substack	Publicaciones de boletín, texto de artículos
Escritura	--wordpress <site>	API de WordPress	Publicaciones de blog, categorías, etiquetas
Escritura	--openlibrary <user>	API de Open Library	Libros escritos
Escritura	--orcid <id>	API de ORCID	Publicaciones académicas
Escritura	--semanticscholar <id>	API de S2	Artículos de investigación, citas
Escritura	--youtube <channel>	RSS de YouTube	Videos, información del canal
Comunidad	--stackoverflow <id>	API de Stack Exchange	Etiquetas principales, reputación, insignias
Comunidad	--hackernews <user>	API de HN Firebase	Karma, envíos
Comunidad	--mastodon <user@host>	API de Mastodon	Publicaciones, hashtags, biografía
Comunidad	--bluesky <handle>	API de AT Protocol	Publicaciones, seguidores
Comunidad	--reddit <user>	API JSON de Reddit	Karma, biografía
Comunidad	--producthunt <user>	GraphQL de ProductHunt	Productos lanzados, votos positivos
Comunidad	--threads <user>	API de Threads	Biografía, estadísticas de seguidores
Paquetes	--npm <user>	Registro npm	Paquetes publicados
Paquetes	--pypi <pkgs>	API JSON de PyPI	Metadatos de paquetes
Paquetes	--crates <user>	API de Crates.io	Crates de Rust
Paquetes	--dockerhub <user>	API de Docker Hub	Imágenes de contenedores
Actividad	--wakatime <user>	API de WakaTime	Tiempo de codificación, lenguajes, editores

Copia de seguridad XML de Blogger

--blogger-backup importa contenido escrito desde un archivo de exportación XML de Blogger en disco. Está diseñado para blogs archivados o con múltiples autores donde quieras recuperar tus publicaciones incluso si el sitio es antiguo, está parcialmente fuera de línea o no se puede consultar fácilmente mediante una API pública.

Por defecto importa todas las entradas de publicaciones del archivo. Si la copia de seguridad contiene varios autores, añade ::author1,author2,... después de la ruta del archivo para conservar solo las publicaciones cuyo nombre de autor o correo electrónico coincida con uno de esos valores.

Ejemplos:

# Import all posts from a Blogger export
mcp-me generate --blogger-backup ~/Downloads/blog-2026-03-24.xml

# Import only posts written by specific authors/emails
mcp-me generate --blogger-backup "~/Downloads/blog.xml::fernandopalad@gmail.com,fnpaladini@gmail.com,Fernando Paladini"

Cómo obtener el archivo de exportación:

1. Abre Blogger y elige tu blog.
2. Ve a Settings.
3. En Manage blog, haz clic en Back up content.
4. Descarga el archivo XML.
5. Pasa esa ruta de archivo a --blogger-backup. El generador importa publicaciones coincidentes en projects.yaml con category: article, conserva las etiquetas de las publicaciones como tags y añade entradas de FAQ resumidas sobre el archivo. | Actividad | --letterboxd <user> | Letterboxd RSS | Películas vistas, calificaciones | | Actividad | --goodreads <user> | Goodreads RSS + página de autor | Libros leídos, estanterías, reseñas, libros publicados | | Actividad | --chess <user> | Chess.com API | Calificación, estadísticas | | Actividad | --lichess <user> | Lichess API | Calificación, partidas | | Actividad | --codewars <user> | Codewars API | Rango, honor, lenguajes | | Actividad | --leetcode <user> | LeetCode GraphQL | Problemas resueltos, concursos | | Actividad | --lastfm <user> | Last.fm API | Historial de escucha, artistas principales | | Actividad | --steam <id> | Steam API | Juegos, tiempo de juego | | Actividad | --twitch <user> | Twitch API | Información del stream | | Actividad | --dribbble <user> | Dribbble | Diseños, portafolio | | Actividad | --unsplash <user> | Unsplash API | Fotos, descargas, colecciones | | Actividad | --exercism <user> | Exercism API | Rutas de idiomas, ejercicios | | Actividad | --hackerrank <user> | HackerRank API | Insignias, desafíos resueltos | | Actividad | --anilist <user> | AniList GraphQL | Estadísticas de anime/manga, géneros | | Identidad | --gravatar <email> | Gravatar API | Bio, cuentas vinculadas, foto | | Identidad | --keybase <user> | Keybase API | Pruebas de identidad verificadas |

¿Quieres añadir una nueva fuente de datos? Consulta la Guía de creación de generadores.

Plugins (13 integraciones en vivo)

Los plugins se ejecutan durante mcp-me serve y proporcionan datos en tiempo real a los asistentes de IA en cada consulta.

Plugin	Descripción	Autenticación
GitHub	Repos en vivo, actividad, lenguajes	Token opcional
Spotify	Reproduciendo ahora, artistas principales, listas de reproducción	OAuth requerido
LinkedIn	Historial profesional desde exportación	Archivo JSON local
WakaTime	Estadísticas de codificación en vivo, lenguajes	Clave API opcional
DEV.to	Artículos en vivo, reacciones	Clave API opcional
Bluesky	Publicaciones en vivo, perfil, seguidores	Ninguno
Hacker News	Historias en vivo, karma	Ninguno
Reddit	Karma en vivo, publicaciones	Ninguno
GitLab	Proyectos en vivo, actividad, MRs	Token opcional
Mastodon	Toots en vivo, perfil, interacción	Ninguno
YouTube	Videos en vivo, estadísticas del canal	Clave API opcional
Last.fm	Reproduciendo ahora, artistas principales, scrobbles	Clave API opcional
Steam	Reproduciendo actualmente, biblioteca de juegos	Clave API opcional

Habilita los plugins en .mcp-me.yaml:

plugins:
  github:
    enabled: true
    username: "your-username"
  spotify:
    enabled: true
    client_id_env: "SPOTIFY_CLIENT_ID"
    client_secret_env: "SPOTIFY_CLIENT_SECRET"
    refresh_token_env: "SPOTIFY_REFRESH_TOKEN"

Los plugins de la comunidad se instalan desde npm (mcp-me-plugin-*) y se descubren automáticamente. Consulta la Guía de creación de plugins.

Generadores vs Plugins

	Generadores	Plugins
Cuándo se ejecutan	mcp-me generate (una vez)	mcp-me serve (continuamente)
Salida	Archivos YAML estáticos	Recursos/herramientas MCP en vivo
Autenticación	Casi nunca se necesita	A veces (OAuth)
Ejemplo	"Repos que tenía en marzo"	"Repos que tengo ahora"
Extender	Añade src/generators/*.ts	Añade src/plugins/*/

Referencia de CLI

# Auto-generate profile from multiple data sources
mcp-me generate [--directory] --github <user> [--devto <user>] [--stackoverflow <id>] ...

# Initialize with blank YAML templates (defaults to ~/.mcp-me)
mcp-me init [directory]

# Validate profile YAML files
mcp-me validate [directory]

# Start the MCP server (defaults to ~/.mcp-me)
mcp-me serve [directory]

# Scaffold a new generator or plugin (for contributors)
mcp-me create generator <name> [--category <category>]
mcp-me create plugin <name>

Ubicación del perfil: Por defecto en ~/.mcp-me. Sobrescribe con MCP_ME_PROFILE_DIR o pasa un argumento explícito [directory].

Desarrollo

# Clone the repo
git clone https://github.com/paladini/mcp-me.git
cd mcp-me

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run in dev mode
npm run dev

Preguntas frecuentes

¿Qué es MCP (Model Context Protocol)? MCP es un estándar abierto de Anthropic que conecta asistentes de IA con fuentes de datos externas. mcp-me usa MCP para permitir que los asistentes de IA lean tus datos de perfil personal.

¿Necesito claves de API? La mayoría de los generadores usan APIs públicas sin necesidad de autenticación. Algunos (Strava, Spotify) requieren tokens — consulta los comentarios de .mcp-me.yaml para más detalles.

¿Puedo usar esto con Claude Desktop / VS Code / Cursor / Windsurf? ¡Sí! Cualquier asistente de IA compatible con MCP funciona. Consulta la sección Configura tu asistente de IA.

¿Cómo hago que los agentes de IA usen mi perfil automáticamente? Coloca un AGENTS.md (para Windsurf, Cline, Codex) o un .github/copilot-instructions.md (para GitHub Copilot) en tu proyecto. Se incluyen plantillas — consulta la Guía de instrucciones para agentes.

¿Cómo añado una nueva fuente de datos? Ejecuta mcp-me create generator myservice para crear un nuevo generador, o consulta la Guía de creación de generadores.

¿Se almacenan mis datos en algún lugar? No. Todos los datos permanecen localmente en tus archivos YAML. El servidor MCP lee desde el disco — no se envía nada a ninguna nube.

¿Cuántos generadores hay? Actualmente hay 329 generadores registrados, implementados en 44 archivos fuente de generadores más 15 archivos por lotes.

Contribuciones

¡Agradecemos las contribuciones! Ya sea un nuevo plugin, una corrección de errores o mejoras en la documentación — consulta CONTRIBUTING.md para las pautas.

Mantenedores: consulta la Guía de publicación para instrucciones de lanzamiento y distribución.

Licencia

MIT