反射技能MCP
反射技能MCP 是一个开源 模型上下文协议（MCP）服务器 它提供了一套小而精心策划的 开发人员本机反射框架、练习和提示包.
它的设计用途是：
- 日记和反思应用程序（如Jots）
- 指导或辅导代理人
- 开发生产力工具
- 回顾性工具
- 个人代理工作流
服务器公开了返回的MCP工具 结构化、基于证据的反思指导，可根据深度和上下文进行配置。
v1被有意限定为 10张高杠杆卡 保持质量和连贯性。
______________________________________________________________________
此回购包含什么
这是一个 单体仓库 有四个主要问题：
- 模式 –共享JSON模式和TypeScript类型
- 数据集 –策划的反射“卡片”+搜索索引
- 服务器 –MCP服务器暴露反射工具
- 工具 –CLI、评估、示例和CI
反思技能mcp/ ├─ docs/#规范文档 ├─ 包裹/ │ ├─ 模式/#模式+TS类型 │ ├─ 数据集/#卡片+索引 │ ├─ 服务器/#MCP服务器（stdio/HTTP） │ ├─ cli/#本地运行程序+实用程序 │ ├─ evals/#检索质量评估 │ └─ examples/#客户端示例 └─ .github/工作流/#CI
______________________________________________________________________
什么是“卡”？
A. 卡 是一个小型的、结构化的反射知识单元：
- 框架（如SBAR、权衡分析）
- 练习（例如5个为什么）
- 提示包（如每日脉搏）
每张卡是：
- 简短且可操作
- 用开发人员语言编写
- 标记为a 小型固定标签集
- 获得再利用许可
开发者原生标签（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
______________________________________________________________________
在本地运行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服务器作为远程MCP服务，例如通过Streamable HTTP。
数据集（v1）
v1恰好包含10张卡：
框架/ 练习/ 提示包/ 研究/（保留，v1中为空）
卡片位于： 包/数据集/卡/v1/
索引在以下位置预先计算： 包/数据集/索引/cards.index.json
请参阅docs/dataset-guide.md 文档/卡片授权.md
撤离
该仓库包括轻量级检索评估，以防止回归。
输入：包/evals/cases/v1.jsonl
韵律学：precision@k, recall@k
运行：
npm --prefix packages/evals run evals请参阅docs/evals.md
潜在用例
反射技能MCP是有意通用和可重用的。常见用例包括：
- 日记和反思应用程序
提供结构化的反思指导、每日脉冲和框架，而无需构建自己的内容引擎。
- 辅导或指导代理人
通过一致的反思框架为“支持性伙伴”、“高级工程师”或“领导”角色提供动力。
- 开发人员生产力工具
将PR后、事件后或日终反思提示添加到现有工作流中。
- 回顾与团队学习
支持使用共享语言和结构的轻量级回溯、事后分析和决策评审。
- 个人代理工作流程
通过MCP作为反射知识层插入本地或远程代理设置。
MCP是无状态的、开源的，不需要访问用户数据，因此可以在多种环境中安全集成。
这个回购不是什么
❌ 日记应用程序 ❌ 个性化引擎 ❌ 治疗或心理健康系统 ❌ 托管SaaS
它是一个便携式反射知识服务器。
贡献
欢迎投稿，但有意限定范围。
请阅读：
贡献.md 文档/卡片授权.md
v2扩展应该首先通过issues提出。
许可证
- 代码 根据 MIT许可证
- 反射卡内容 （框架、练习、提示包）根据 CC 4.0
此存储库中引用的框架是行业标准方法。 原始框架不被视为原创作品；这里只许可卡片的策划、结构和措辞。