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許可證。

本倉庫中引用的框架是行業標準方法。原始框架不被視為原創作品，僅對卡片的策劃、結構和措辭進行許可。