mcp-me

mcp-me

你的 AI 助手并不了解你。 每次你与 Claude、Copilot、Cursor 或 Windsurf 开始对话时，都是一张白纸——没有关于你的技能、项目、职业经历或关注事项的上下文。

mcp-me 可以解决这个问题。 它会创建一个结构化的个人资料，任何 AI 助手都可以通过 Model Context Protocol (MCP) 读取。你可以把它看作面向 AI 的数字身份层——你的简介、职业经历、技能、兴趣、项目等信息，始终对你使用的每个 AI 工具开放。

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

为什么选择 mcp-me？

• 了解你的 AI — 你的助手会在每次对话中记住你的技能、职业经历、项目和个性
• 自动生成 — 通过一个命令，从 329 个已注册生成器（由 44 个生成器源文件实现）提取数据
• 隐私优先 — 所有数据都以 YAML 文件形式保存在你的本地设备上，不会发送到任何云端
• 实时插件 — 13 个实时集成（Spotify 正在播放内容、GitHub 仓库、Last.fm 收听记录），AI 可按需查询
• 可扩展 — 由社区驱动的生成器和插件。只需约 10 行代码即可添加新的数据源。
• 随处可用 — Claude Desktop、Cursor、Windsurf、Copilot，以及任何兼容 MCP 的 AI 助手

安装

前提条件： Node.js 20 或更高版本。使用 node -v 验证。

一键安装

只需单击一下，即可将 mcp-me 添加到你的 AI 助手中——无需配置路径（配置文件默认位于 ~/.mcp-me）：

  

Claude Desktop： 下载最新的 .mcpb 版本，然后双击安装，或将其拖入 Claude Desktop → Settings → Extensions。

安装后，初始化你的配置文件：

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

npm（推荐）

npm install -g mcp-me

这样就可以在系统的任何位置使用 mcp-me 命令。无需克隆任何仓库——npm 会为你下载软件包。

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

替代方式——无需安装即可运行（通过 npx）：

npx mcp-me --help

npx 会临时下载软件包并运行。适合尝试一次 mcp-me，但重复使用时速度较慢，因为每次都会重新下载。

配置文件位置： 命令默认使用 ~/.mcp-me。可通过 MCP_ME_PROFILE_DIR 覆盖，或传入显式路径：mcp-me serve ~/my-profile。

快速入门

# 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

你的 .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

也可以使用 CLI 标志： mcp-me generate --github octocat --devto myuser

所有命令都可以通过 npx（零安装）运行，也可以在全局安装后直接使用 mcp-me。generate 命令会从公共 API 获取你的数据，并自动填充配置文件 YAML 文件——大多数数据源都不需要 API 密钥。

配置文件目录结构

~/.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)

配置你的 AI 助手

一键安装（Cursor 和 VS Code）

使用上方的一键安装徽章。安装后，运行 mcp-me init 创建你的配置文件。

Cursor Plugin（Open Plugins）

mcp-me 以完整的 Open Plugins 插件形式提供给 Cursor。可从 cursor.directory 安装或克隆代码仓库——插件会自动检测所有组件：

组件	位置	用途
MCP 服务	mcp.json	零配置运行 npx -y mcp-me serve
规则	rules/	回答前始终查阅个人资料
技能	skills/	个人资料使用和设置指南
Agent	agents/	个人资料助手和简介撰写器
命令	commands/	/ask-about-me 和 /introduce-me
钩子	hooks/hooks.json	会话启动时提醒查阅个人资料
LSP	.lsp.json	为个人资料文件提供 YAML 语言服务器

验证插件结构：npm run validate:open-plugin

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

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

Cursor（手动配置）

添加到项目根目录下的 .cursor/mcp.json：

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

VS Code（GitHub Copilot）

添加到项目根目录下的 .vscode/mcp.json（或添加到用户设置中以全局使用）：

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

提示： 要全局启用（用于所有工作区），请打开 VS Code 设置（Ctrl+Shift+P → “Preferences: Open User Settings (JSON)”），然后在那里添加 mcp 键。

Claude Desktop

选项 A — 桌面扩展（.mcpb，推荐）：

1. 从 GitHub Releases 下载 mcp-me.mcpb
2. 双击该文件，或将它拖入 Claude Desktop → Settings → Extensions
3. 在出现提示时设置个人资料目录（默认：~/.mcp-me）
4. 如果尚未创建个人资料，请运行 mcp-me init

选项 B — 手动配置：

添加到 Claude Desktop 配置中：

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

Agent 指令文件

AI Agent 会读取项目中的特殊 Markdown 文件，以了解应如何运行。将它们与 mcp-me 配合使用，让每次 AI 会话都自动查阅你的个人资料——无需在每次对话中反复介绍你的技术栈、职业经历或偏好。

文件	适用对象
AGENTS.md（项目根目录）	Windsurf（Cascade）、OpenAI Codex、Cline 等
.github/copilot-instructions.md	GitHub Copilot（VS Code + GitHub.com）

快速设置：

# 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

mcp-me 附带这两个模板，它们会指示 AI 在了解你的背景有助于改进回答时调用 ask_about_me。

示例、全局设置以及与项目专属规则结合使用的技巧，请参阅 Agent 指令指南。

个人资料架构

你的个人资料由一组 YAML 文件组成：

文件	描述
identity.yaml	姓名、简介、所在地、语言、联系信息
career.yaml	工作经历、教育背景、认证
skills.yaml	技术技能和软技能及熟练程度
interests.yaml	爱好、音乐、书籍、电影、饮食偏好
personality.yaml	价值观、特质、MBTI、优势
goals.yaml	短期、中期和长期目标
projects.yaml	个人项目和开源项目
faq.yaml	关于你自己的自定义问答

完整文档请参阅 架构参考。

MCP 接口

资源

以 MCP 资源形式提供的静态个人资料数据：

• me://identity — 个人身份信息和联系方式
• me://career — 职业经历
• me://skills — 技能和熟练程度
• me://interests — 爱好和偏好
• me://personality — 个性特质和价值观
• me://goals — 个人和职业目标
• me://projects — 作品集和项目
• me://faq — 常见问题

工具

• ask_about_me — 关于用户的开放式提问
• search_profile — 按关键词搜索所有个人资料数据

提示词

• introduce_me — 生成一段 2 段式介绍
• summarize_career — 总结职业发展历程
• technical_profile — 描述技术技能和技术栈
• collaboration_fit — 评估与某个项目的契合度

生成器（精选示例）

生成器会在运行 mcp-me generate 时调用公共 API 或用户提供的导出数据，自动填充个人资料。大多数来源无需 API 密钥。

当前数量：

• 已注册生成器： 329
• 生成器源文件： 44 个单生成器文件 + 15 个批量文件（src/generators/）

下表列出了常用生成器。权威完整列表见 src/generators/index.ts。

类别	标志	来源	数据
代码	--github <user>	GitHub API	仓库、语言、星标、个人资料
代码	--gitlab <user>	GitLab API	项目、主题、个人资料
代码	--bitbucket <user>	Bitbucket API	仓库、语言
代码	--huggingface <user>	Hugging Face API	模型、数据集、空间
代码	--kaggle <user>	Kaggle API	竞赛、数据集、奖牌
代码	--codeberg <user>	Gitea API	仓库、语言
写作	--devto <user>	DEV.to API	文章、标签、互动
写作	--medium <user>	Medium RSS	文章、分类、文章正文
写作	--blogger-backup <xml>	Blogger XML 导出	从本地备份导入的帖子，可按需筛选作者
写作	--hashnode <user>	Hashnode GraphQL	博客文章、标签
写作	--substack <user>	Substack RSS	新闻通讯文章、文章正文
写作	--wordpress <site>	WordPress API	博客文章、分类、标签
写作	--openlibrary <user>	Open Library API	著作书籍
写作	--orcid <id>	ORCID API	学术出版物
写作	--semanticscholar <id>	S2 API	研究论文、引用
写作	--youtube <channel>	YouTube RSS	视频、频道信息
社区	--stackoverflow <id>	Stack Exchange API	热门标签、声望、徽章
社区	--hackernews <user>	HN Firebase API	Karma、投稿
社区	--mastodon <user@host>	Mastodon API	帖子、话题标签、简介
社区	--bluesky <handle>	AT Protocol API	帖子、关注者
社区	--reddit <user>	Reddit JSON API	Karma、简介
社区	--producthunt <user>	ProductHunt GraphQL	已发布产品、赞成票
社区	--threads <user>	Threads API	简介、关注者统计
软件包	--npm <user>	npm Registry	已发布软件包
软件包	--pypi <pkgs>	PyPI JSON API	软件包元数据
软件包	--crates <user>	Crates.io API	Rust crate
软件包	--dockerhub <user>	Docker Hub API	容器镜像
活动	--wakatime <user>	WakaTime API	编码时间、语言、编辑器

Blogger XML 备份

--blogger-backup 可从磁盘上的 Blogger XML 导出文件导入书面内容。它适用于存档博客或多作者博客，即使网站年代久远、部分无法访问，或难以通过公共 API 查询，也能恢复其中的帖子。

默认情况下，它会导入文件中的所有帖子条目。如果备份包含多位作者，可在文件路径后追加 ::author1,author2,...，仅保留作者名称或电子邮件与其中某个值匹配的帖子。

示例：

# 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::[email protected],[email protected],Fernando Paladini"

如何获取导出文件：

1. 打开 Blogger 并选择你的博客。
2. 前往 Settings。
3. 在 Manage blog 中，点击 Back up content。
4. 下载 XML 文件。
5. 将该文件路径传给 --blogger-backup。

生成器会将匹配的帖子导入 projects.yaml，并设置 category: article，将帖子标签保留为标签，还会添加关于该存档的摘要常见问题条目。 | 活动 | --letterboxd <user> | Letterboxd RSS | 观看过的电影、评分 | | 活动 | --goodreads <user> | Goodreads RSS + 作者页面 | 读过的书、书架、书评、已出版的书 | | 活动 | --chess <user> | Chess.com API | 评分、统计数据 | | 活动 | --lichess <user> | Lichess API | 评分、对局 | | 活动 | --codewars <user> | Codewars API | 等级、荣誉、语言 | | 活动 | --leetcode <user> | LeetCode GraphQL | 已解决的问题、竞赛 | | 活动 | --lastfm <user> | Last.fm API | 收听记录、最常听的艺人 | | 活动 | --steam <id> | Steam API | 游戏、游玩时间 | | 活动 | --twitch <user> | Twitch API | 直播信息 | | 活动 | --dribbble <user> | Dribbble | 设计作品、作品集 | | 活动 | --unsplash <user> | Unsplash API | 照片、下载量、合集 | | 活动 | --exercism <user> | Exercism API | 语言学习轨道、练习 | | 活动 | --hackerrank <user> | HackerRank API | 徽章、已解决的挑战 | | 活动 | --anilist <user> | AniList GraphQL | 动漫/漫画统计数据、类型 | | 身份 | --gravatar <email> | Gravatar API | 简介、关联账户、照片 | | 身份 | --keybase <user> | Keybase API | 已验证的身份证明 |

想要添加新的数据源？请参阅生成器创建指南。

插件（13 个已启用的集成）

插件在 mcp-me serve 运行期间执行，并在每次查询时向 AI 助手提供实时数据。

插件	描述	身份验证
GitHub	实时仓库、活动、语言	可选令牌
Spotify	正在播放、最常听的艺人、播放列表	需要 OAuth
LinkedIn	从导出文件获取职业经历	本地 JSON 文件
WakaTime	实时代码统计、语言	可选 API 密钥
DEV.to	实时文章、互动	可选 API 密钥
Bluesky	实时帖子、个人资料、关注者	无
Hacker News	实时动态、karma	无
Reddit	实时 karma、帖子	无
GitLab	实时项目、活动、合并请求	可选令牌
Mastodon	实时嘟文、个人资料、互动	无
YouTube	实时视频、频道统计数据	可选 API 密钥
Last.fm	正在播放、最常听的艺人、播放记录	可选 API 密钥
Steam	正在游玩的游戏、游戏库	可选 API 密钥

在 .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"

社区插件通过 npm（mcp-me-plugin-*）安装，并会自动发现。请参阅插件创建指南。

生成器与插件的区别

	生成器	插件
运行时机	mcp-me generate（一次）	mcp-me serve（持续运行）
输出	静态 YAML 文件	实时 MCP 资源/工具
身份验证	几乎不需要	有时需要（OAuth）
示例	“我 3 月份有的仓库”	“我现在有的仓库”
扩展方式	添加 src/generators/*.ts	添加 src/plugins/*/

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>

配置文件位置： 默认位于 ~/.mcp-me。可通过 MCP_ME_PROFILE_DIR 覆盖，或传入显式的 [directory] 参数。

开发

# 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

常见问题

什么是 MCP（Model Context Protocol）？ MCP 是 Anthropic 推出的开放标准，用于将 AI 助手连接到外部数据源。mcp-me 使用 MCP，让 AI 助手能够读取你的个人资料数据。

我需要 API 密钥吗？ 大多数生成器使用无需身份验证的公共 API。部分服务（Strava、Spotify）需要令牌——详情请参阅 .mcp-me.yaml 中的注释。

我可以将它与 Claude Desktop / VS Code / Cursor / Windsurf 搭配使用吗？ 可以！任何兼容 MCP 的 AI 助手都能使用。请参阅配置你的 AI 助手一节。

如何让 AI Agent 自动使用我的个人资料？ 将 AGENTS.md（适用于 Windsurf、Cline、Codex）或 .github/copilot-instructions.md（适用于 GitHub Copilot）放入你的项目中。项目已包含模板——请参阅 Agent 指令指南。

如何添加新的数据源？ 运行 mcp-me create generator myservice 来搭建新的生成器，或参阅生成器创建指南。

我的数据会存储在其他地方吗？ 不会。所有数据都保留在本地的 YAML 文件中。MCP 服务会从磁盘读取数据——不会向任何云端发送内容。

目前有多少个生成器？ 目前已注册 329 个生成器，分布在 44 个生成器源文件和 15 个批处理文件中。

贡献

欢迎贡献！无论是新增插件、修复 bug，还是改进文档，请参阅 CONTRIBUTING.md 了解贡献指南。

维护者请参阅发布指南，了解发布和分发说明。

许可证

MIT