Reflection Skills MCP

🚀 反思技能MCP

反思技能MCP 是一个开源的 模型上下文协议（MCP）服务器，它提供了一小套精心策划的 面向开发者的反思框架、练习和提示包。

该项目旨在供以下场景使用：

• 日记和反思类应用（如Jots）
• 辅导或指导代理
• 开发者生产力工具
• 回顾工具
• 个人代理工作流程

服务器提供的MCP工具可返回 结构化、基于证据的反思指导，并可根据深度和上下文进行配置。

v1版本特意限定为 10张高价值卡片，以保证质量和连贯性。

🚀 快速开始

本地运行MCP服务器（推荐）

大多数MCP用户通过标准输入输出（stdio）在本地运行服务器。

远程/托管（可选）

对于生产环境或远程访问，MCP服务器也可以通过HTTP运行。项目中包含一个Dockerfile，以支持在各平台上进行部署。

安装与构建

npm install
npm run build
node packages/server/build/index.js

将你的MCP主机（如Claude Desktop、VS Code等）配置为运行以下命令：

{
  "command": "node",
  "args": ["ABSOLUTE_PATH/packages/server/build/index.js"]
}

无需托管服务。在生产环境中，你可以将此MCP服务器用作基于可流式HTTP的远程MCP服务。

✨ 主要特性

项目结构

这是一个 单仓库多项目（monorepo），主要包含四个方面：

1. Schema – 共享的JSON模式和TypeScript类型
2. Dataset – 精心策划的反思 “卡片” 及搜索索引
3. Server – 提供反思工具的MCP服务器
4. Tooling – 命令行工具（CLI）、评估工具、示例和持续集成（CI）

项目结构如下：

reflection-skills-mcp/
├─ docs/ # 权威文档
├─ packages/
│ ├─ schema/ # 模式 + TS类型
│ ├─ dataset/ # 卡片 + 索引
│ ├─ server/ # MCP服务器（标准输入输出 / HTTP）
│ ├─ cli/ # 本地运行器 + 实用工具
│ ├─ evals/ # 检索质量评估
│ └─ examples/ # 客户端示例
└─ .github/workflows/ # 持续集成

“卡片” 定义

卡片 是一种小型的、结构化的反思知识单元：

• 框架（如SBAR、权衡分析）
• 练习（如5个为什么）
• 提示包（如每日动态）

每张卡片具有以下特点：

• 简短且可操作
• 使用开发者语言编写
• 带有 少量固定标签
• 可被许可复用

面向开发者的标签（v1）

事件 · 决策 · 协作 · 发布 · 学习 · 调试

暴露的MCP工具

服务器提供以下MCP工具：

• reflection.search_cards：通过查询、标签或类型搜索卡片。
• reflection.get_card：通过ID获取完整卡片。
• reflection.recommend：根据信号（重点领域、用例）和配置推荐卡片。
• reflection.daily_pulse：生成每日动态消息、小提示和建议卡片。

所有工具：

• 接受 部分配置
• 应用 合理的默认值
• 从不要求用户特定数据

完整详情请参阅 。

配置模型

所有工具都接受一个可选的 ReflectionContextConfig 对象。你可以控制以下方面：

• 深度（quick | standard | deep）
• 受众级别（junior | mid | senior | staff_plus）
• 关注维度（清晰度、权衡、学习等）
• 时间预算
• 输出大小
• 用例（反思后、每日动态、每周回顾）

如果未提供配置，将应用 安全的默认值。 模式定义位于：packages/schema/json/ReflectionContextConfig.schema.json

📦 安装指南

安装与构建

npm install
npm run build
node packages/server/build/index.js

配置运行

将你的MCP主机（如Claude Desktop、VS Code等）配置为运行以下命令：

{
  "command": "node",
  "args": ["ABSOLUTE_PATH/packages/server/build/index.js"]
}

💻 使用示例

基础用法

# 安装依赖
npm install
# 构建项目
npm run build
# 启动服务器
node packages/server/build/index.js

高级用法

{
  "command": "node",
  "args": ["ABSOLUTE_PATH/packages/server/build/index.js"]
}

📚 详细文档

数据集（v1）

v1版本包含10张卡片：

• frameworks/
• exercises/
• prompt-packs/
• studies/ （预留，v1版本为空）

卡片位于：packages/dataset/cards/v1/ 索引预计算于：packages/dataset/indexes/cards.index.json

详细信息请参阅 docs/dataset-guide.md 和 docs/card-authoring.md。

评估

仓库中包含轻量级的检索评估工具，以防止性能退化。

• 输入：packages/evals/cases/v1.jsonl
• 指标：precision@k, recall@k

运行评估命令：

npm --prefix packages/evals run evals

详细信息请参阅 docs/evals.md。

潜在用例

反思技能MCP具有通用性和可复用性，常见用例包括：

• 日记和反思类应用：无需构建自己的内容引擎，即可提供结构化的反思指导、每日动态和框架。
• 辅导或指导代理：使用一致的反思框架为 “支持伙伴”、“资深工程师” 或 “负责人” 等角色提供支持。
• 开发者生产力工具：在现有工作流程中添加PR后、事件后或一天结束时的反思提示。
• 回顾与团队学习：通过共享的语言和结构支持轻量级回顾、事后分析和决策审查。
• 个人代理工作流程：通过MCP作为反思知识层接入本地或远程代理设置。

MCP是无状态的、开源的，且不需要访问用户数据，因此可以安全地集成到多种环境中。

项目不包含的内容

❌ 日记应用 ❌ 个性化引擎 ❌ 治疗或心理健康系统 ❌ 托管的软件即服务（SaaS）

它是一个可移植的反思知识服务器。

贡献

欢迎贡献代码，但贡献范围是经过精心规划的。请阅读：

• CONTRIBUTING.md
• docs/card-authoring.md

v2版本的扩展应先通过issue提出建议。

📄 许可证

• 代码 采用 MIT许可证。
• 反思卡片内容（框架、练习、提示包）采用 CC BY 4.0许可证。

本仓库中引用的框架是行业标准方法。原始框架不被视为原创作品，仅对卡片的策划、结构和措辞进行许可。