mcp-me

mcp-me

Seus assistentes de IA não sabem quem você é. Toda vez que você inicia uma conversa com Claude, Copilot, Cursor ou Windsurf, é uma página em branco — sem contexto sobre suas habilidades, seus projetos, sua carreira ou o que importa para você.

O mcp-me resolve isso. Ele cria um perfil pessoal estruturado que qualquer assistente de IA pode ler via Model Context Protocol (MCP). Pense nele como uma camada de identidade digital para IA — sua bio, carreira, habilidades, interesses, projetos e muito mais, sempre disponíveis para todas as ferramentas de IA que você usa.

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 que mcp-me?

• IA que conhece você — Seus assistentes lembram suas habilidades, carreira, projetos e personalidade em todas as conversas
• Gerado automaticamente — Busca dados de 329 geradores registrados (implementados em 44 arquivos-fonte de geradores) com um único comando
• Privacidade em primeiro lugar — Todos os dados permanecem locais em arquivos YAML na sua máquina. Nada é enviado para nenhuma nuvem.
• Plugins em tempo real — 13 integrações ao vivo (Spotify tocando agora, repositórios GitHub, scrobbles Last.fm) que a IA consulta sob demanda
• Extensível — Geradores e plugins orientados pela comunidade. Adicione uma nova fonte de dados em cerca de 10 linhas de código.
• Funciona em qualquer lugar — Claude Desktop, Cursor, Windsurf, Copilot e qualquer assistente de IA compatível com MCP

Instalação

Pré-requisito: Node.js 20 ou superior. Verifique com node -v.

Instalação com um clique

Adicione o mcp-me ao seu assistente de IA com um clique — sem necessidade de configurar caminhos (o perfil usa como padrão ~/.mcp-me):

  

Claude Desktop: Baixe o release .mcpb mais recente e clique duas vezes para instalar, ou arraste-o para Claude Desktop → Configurações → Extensões.

Após instalar, inicialize seu perfil:

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

npm (recomendado)

npm install -g mcp-me

Isso torna o comando mcp-me disponível em qualquer lugar do seu sistema. Não é necessário clonar nenhum repositório — o npm baixa o pacote para você.

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

Alternativa — executar sem instalar (via npx):

npx mcp-me --help

npx baixa o pacote temporariamente e o executa. Útil para experimentar o mcp-me uma vez, mas mais lento em uso repetido, pois baixa novamente a cada execução.

Localização do perfil: Os comandos usam como padrão ~/.mcp-me. Substitua com MCP_ME_PROFILE_DIR ou passe um caminho explícito: mcp-me serve ~/my-profile.

Início 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

Seu arquivo de configuração .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

As flags de CLI também funcionam: mcp-me generate --github octocat --devto myuser

Todos os comandos funcionam com npx (instalação zero) ou com mcp-me diretamente se instalado globalmente. O comando generate busca seus dados de APIs públicas e preenche automaticamente os arquivos YAML do perfil — sem necessidade de chaves de API para a maioria das fontes.

Estrutura do diretório do 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)

Configure seu assistente de IA

Um clique (Cursor e VS Code)

Use os badges de instalação com um clique acima. Após instalar, execute mcp-me init para criar seu perfil.

Plugin Cursor (Open Plugins)

O mcp-me é distribuído como um plugin Open Plugins completo para Cursor. Instale a partir de cursor.directory ou clone o repositório — o plugin detecta automaticamente todos os componentes:

Componente	Localização	Finalidade
Servidor MCP	mcp.json	npx -y mcp-me serve sem configuração
Regras	rules/	Sempre consultar o perfil antes de responder
Habilidades	skills/	Guias de uso e configuração do perfil
Agentes	agents/	Assistente de perfil e redator de introdução
Comandos	commands/	/ask-about-me e /introduce-me
Hooks	hooks/hooks.json	Lembrete de perfil no início da sessão
LSP	.lsp.json	Servidor de linguagem YAML para arquivos de perfil

Valide a estrutura do plugin: npm run validate:open-plugin

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

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

Cursor (manual)

Adicione a .cursor/mcp.json na raiz do seu projeto:

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

VS Code (GitHub Copilot)

Adicione a .vscode/mcp.json na raiz do seu projeto (ou nas Configurações do Usuário para acesso global):

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

Dica: Para habilitar globalmente (todos os workspaces), abra as Configurações do VS Code (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") e adicione a chave mcp lá.

Claude Desktop

Opção A — Extensão de Desktop (.mcpb, recomendada):

1. Baixe mcp-me.mcpb de GitHub Releases
2. Clique duas vezes no arquivo, ou arraste-o para Claude Desktop → Configurações → Extensões
3. Defina seu diretório de perfil quando solicitado (padrão: ~/.mcp-me)
4. Execute mcp-me init se você ainda não criou um perfil

Opção B — Configuração manual:

Adicione à configuração do Claude Desktop:

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

Arquivos de instrução para agentes

Os agentes de IA leem arquivos Markdown especiais no seu projeto para entender como devem se comportar. Combine-os com o mcp-me para que toda sessão de IA consulte automaticamente seu perfil — sem repetir sua stack, carreira ou preferências em toda conversa.

Arquivo	Funciona com
AGENTS.md (raiz do projeto)	Windsurf (Cascade), OpenAI Codex, Cline e outros
.github/copilot-instructions.md	GitHub Copilot (VS Code + GitHub.com)

Configuração 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

Ambos os modelos estão incluídos no mcp-me e instruem a IA a chamar ask_about_me sempre que contexto sobre você melhorar a resposta.

Consulte o Guia de Instruções para Agentes para exemplos, configuração global e dicas sobre como combinar com regras específicas do projeto.

Esquema do perfil

Seu perfil é uma coleção de arquivos YAML:

Arquivo	Descrição
identity.yaml	Nome, bio, localização, idiomas, informações de contato
career.yaml	Experiência profissional, educação, certificações
skills.yaml	Habilidades técnicas e interpessoais com níveis de proficiência
interests.yaml	Hobbies, música, livros, filmes, preferências alimentares
personality.yaml	Valores, traços, MBTI, pontos fortes
goals.yaml	Metas de curto, médio e longo prazo
projects.yaml	Projetos pessoais e de código aberto
faq.yaml	Pares personalizados de perguntas e respostas sobre você

Consulte a Referência do Esquema para documentação completa.

Interface MCP

Recursos

Dados estáticos do perfil expostos como recursos MCP:

• me://identity — Identidade pessoal e contato
• me://career — Histórico profissional
• me://skills — Habilidades e proficiências
• me://interests — Hobbies e preferências
• me://personality — Traços de personalidade e valores
• me://goals — Metas pessoais e profissionais
• me://projects — Portfólio e projetos
• me://faq — Perguntas frequentes

Ferramentas

• ask_about_me — Pergunta de formato livre sobre o usuário
• search_profile — Busca por palavras-chave em todos os dados do perfil

Prompts

• introduce_me — Gera uma introdução de 2 parágrafos
• summarize_career — Resume a trajetória profissional
• technical_profile — Descreve habilidades técnicas e stack
• collaboration_fit — Avalia adequação para um projeto

Geradores (exemplos selecionados)

Os geradores são executados durante mcp-me generate para preencher automaticamente seu perfil a partir de APIs públicas ou exportações fornecidas pelo usuário. Sem necessidade de chaves de API para a maioria das fontes.

Contagens atuais:

• Geradores registrados: 329
• Arquivos-fonte de geradores: 44 arquivos de gerador único + 15 arquivos em lote (src/generators/)

A tabela abaixo é uma lista selecionada de geradores comumente usados. A fonte completa da verdade é src/generators/index.ts.

Categoria	Flag	Fonte	Dados
Código	--github <user>	GitHub API	Repositórios, linguagens, estrelas, perfil
Código	--gitlab <user>	GitLab API	Projetos, tópicos, perfil
Código	--bitbucket <user>	Bitbucket API	Repositórios, linguagens
Código	--huggingface <user>	Hugging Face API	Modelos, datasets, spaces
Código	--kaggle <user>	Kaggle API	Competições, datasets, medalhas
Código	--codeberg <user>	Gitea API	Repositórios, linguagens
Escrita	--devto <user>	DEV.to API	Artigos, tags, reações
Escrita	--medium <user>	Medium RSS	Artigos, categorias, texto dos artigos
Escrita	--blogger-backup <xml>	Blogger XML export	Posts importados de um backup local, filtrados por autor se necessário
Escrita	--hashnode <user>	Hashnode GraphQL	Posts de blog, tags
Escrita	--substack <user>	Substack RSS	Posts de newsletter, texto dos artigos
Escrita	--wordpress <site>	WordPress API	Posts de blog, categorias, tags
Escrita	--openlibrary <user>	Open Library API	Livros de autoria
Escrita	--orcid <id>	ORCID API	Publicações acadêmicas
Escrita	--semanticscholar <id>	S2 API	Artigos de pesquisa, citações
Escrita	--youtube <channel>	YouTube RSS	Vídeos, informações do canal
Comunidade	--stackoverflow <id>	Stack Exchange API	Principais tags, reputação, medalhas
Comunidade	--hackernews <user>	HN Firebase API	Karma, submissões
Comunidade	--mastodon <user@host>	Mastodon API	Posts, hashtags, bio
Comunidade	--bluesky <handle>	AT Protocol API	Posts, seguidores
Comunidade	--reddit <user>	Reddit JSON API	Karma, bio
Comunidade	--producthunt <user>	ProductHunt GraphQL	Produtos lançados, upvotes
Comunidade	--threads <user>	Threads API	Bio, estatísticas de seguidores
Pacotes	--npm <user>	npm Registry	Pacotes publicados
Pacotes	--pypi <pkgs>	PyPI JSON API	Metadados de pacotes
Pacotes	--crates <user>	Crates.io API	Crates Rust
Pacotes	--dockerhub <user>	Docker Hub API	Imagens de contêineres
Atividade	--wakatime <user>	WakaTime API	Tempo de codificação, linguagens, editores

Backup XML do Blogger

--blogger-backup importa conteúdo escrito de um arquivo de exportação XML do Blogger no disco. Ele é projetado para blogs arquivados ou com vários autores, onde você deseja recuperar seus posts mesmo que o site seja antigo, esteja parcialmente offline ou não seja facilmente consultável por uma API pública.

Por padrão, importa todas as entradas de posts do arquivo. Se o backup contiver vários autores, acrescente ::author1,author2,... após o caminho do arquivo para manter apenas os posts cujo nome ou e-mail do autor corresponda a um desses valores.

Exemplos:

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

Como obter o arquivo de exportação:

1. Abra o Blogger e escolha seu blog.
2. Vá para Settings.
3. Em Manage blog, clique em Back up content.
4. Baixe o arquivo XML.
5. Passe o caminho desse arquivo para --blogger-backup. O gerador importa postagens correspondentes para projects.yaml com category: article, preserva os rótulos das postagens como tags e adiciona entradas de FAQ resumidas sobre o arquivo. | Atividade | --letterboxd <user> | Letterboxd RSS | Filmes assistidos, avaliações | | Atividade | --goodreads <user> | Goodreads RSS + página do autor | Livros lidos, estantes, resenhas, livros publicados | | Atividade | --chess <user> | Chess.com API | Rating, estatísticas | | Atividade | --lichess <user> | Lichess API | Rating, partidas | | Atividade | --codewars <user> | Codewars API | Rank, honra, linguagens | | Atividade | --leetcode <user> | LeetCode GraphQL | Problemas resolvidos, competições | | Atividade | --lastfm <user> | Last.fm API | Histórico de audição, artistas mais ouvidos | | Atividade | --steam <id> | Steam API | Jogos, tempo de jogo | | Atividade | --twitch <user> | Twitch API | Informações da transmissão | | Atividade | --dribbble <user> | Dribbble | Shots de design, portfólio | | Atividade | --unsplash <user> | Unsplash API | Fotos, downloads, coleções | | Atividade | --exercism <user> | Exercism API | Trilhas de linguagem, exercícios | | Atividade | --hackerrank <user> | HackerRank API | Medalhas, desafios resolvidos | | Atividade | --anilist <user> | AniList GraphQL | Estatísticas de anime/mangá, gêneros | | Identidade | --gravatar <email> | Gravatar API | Bio, contas vinculadas, foto | | Identidade | --keybase <user> | Keybase API | Provas de identidade verificadas |

Quer adicionar uma nova fonte de dados? Veja o Guia de Criação de Geradores.

Plugins (13 integrações ativas)

Os plugins são executados durante mcp-me serve e fornecem dados em tempo real para assistentes de IA em cada consulta.

Plugin	Descrição	Autenticação
GitHub	Repositórios, atividade, linguagens ao vivo	Token opcional
Spotify	Tocando agora, artistas mais ouvidos, playlists	OAuth obrigatório
LinkedIn	Histórico profissional a partir de exportação	Arquivo JSON local
WakaTime	Estatísticas de codificação ao vivo, linguagens	Chave de API opcional
DEV.to	Artigos, reações ao vivo	Chave de API opcional
Bluesky	Postagens, perfil, seguidores ao vivo	Nenhuma
Hacker News	Histórias, karma ao vivo	Nenhuma
Reddit	Karma, postagens ao vivo	Nenhuma
GitLab	Projetos, atividade, MRs ao vivo	Token opcional
Mastodon	Toots, perfil, engajamento ao vivo	Nenhuma
YouTube	Vídeos, estatísticas do canal ao vivo	Chave de API opcional
Last.fm	Tocando agora, artistas mais ouvidos, scrobbles	Chave de API opcional
Steam	Jogando agora, biblioteca de jogos	Chave de API opcional

Ative os plugins em .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"

Os plugins da comunidade são instalados via npm (mcp-me-plugin-*) e descobertos automaticamente. Veja o Guia de Criação de Plugins.

Geradores vs Plugins

	Geradores	Plugins
Quando executam	mcp-me generate (uma vez)	mcp-me serve (continuamente)
Saída	Arquivos YAML estáticos	Recursos/ferramentas MCP ao vivo
Autenticação	Quase nunca necessária	Às vezes (OAuth)
Exemplo	"Repositórios que tive em março"	"Repositórios que tenho agora"
Extensão	Adicione src/generators/*.ts	Adicione src/plugins/*/

Referência da 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>

Localização do perfil: Padrão em ~/.mcp-me. Substitua com MCP_ME_PROFILE_DIR ou passe um argumento [directory] explícito.

Desenvolvimento

# 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

FAQ

O que é MCP (Model Context Protocol)? MCP é um padrão aberto da Anthropic que conecta assistentes de IA a fontes de dados externas. O mcp-me usa MCP para permitir que assistentes de IA leiam seus dados de perfil pessoal.

Preciso de chaves de API? A maioria dos geradores usa APIs públicas sem necessidade de autenticação. Alguns (Strava, Spotify) exigem tokens — veja os comentários .mcp-me.yaml para detalhes.

Posso usar isso com Claude Desktop / VS Code / Cursor / Windsurf? Sim! Qualquer assistente de IA compatível com MCP funciona. Veja a seção Configure Seu Assistente de IA.

Como faço para agentes de IA usarem meu perfil automaticamente? Coloque um AGENTS.md (para Windsurf, Cline, Codex) ou .github/copilot-instructions.md (para GitHub Copilot) no seu projeto. Modelos estão incluídos — veja o Guia de Instruções para Agentes.

Como adiciono uma nova fonte de dados? Execute mcp-me create generator myservice para criar um novo gerador, ou veja o Guia de Criação de Geradores.

Meus dados são armazenados em algum lugar? Não. Todos os dados permanecem locais nos seus arquivos YAML. O servidor MCP lê do disco — nada é enviado para nenhuma nuvem.

Quantos geradores existem? Atualmente, 329 geradores registrados, implementados em 44 arquivos-fonte de geradores mais 15 arquivos em lote.

Contribuindo

Aceitamos contribuições! Seja um novo plugin, uma correção de bug ou melhorias na documentação — veja CONTRIBUTING.md para diretrizes.

Mantenedores: veja o Guia de Publicação para instruções de lançamento e distribuição.

Licença

MIT