@pcircle/memesh
v2.8.0
Published
MeMesh - Your AI memory mesh for Claude Code. Smart routing, persistent memory, and intelligent task management.
Maintainers
gjmatwReadme
🧠 MeMesh
說明：原名為「Claude Code Buddy (CCB)」，為避免商標侵權問題已更名為 MeMesh。
唯一會記住一切的 MCP Server
讓 Claude Code 記住所有事情。開發更快。Vibe 更爽。
🚀 快速開始 • 📖 文檔 • 🌐 GitHub • 💬 討論區
🎥 實際效果展示
🔴 沒有 MeMesh
# Session 1（週一）
你: "我們用 JWT 做身份驗證，因為..."
Claude: "了解！✅"
# Session 2（週二）
你: "還記得我們的身份驗證方式嗎？"
Claude: "抱歉，我沒有這個 context..."
你: *再解釋一次所有東西* 😤
# Session 3（週三）
你: "我們的 JWT 實作..."
Claude: "什麼 JWT 實作？"
你: *暴怒離開* 💢✅ 有 MeMesh
# Session 1（週一）
你: buddy-do "設定 JWT 身份驗證"
MeMesh: ✅ 已實作 + 儲存到記憶
# Session 2（週二）
你: buddy-remember "auth"
MeMesh: 📚 "JWT 身份驗證實作於 2024-01-15
↳ Access tokens: 15 分鐘
↳ Refresh tokens: 7 天
↳ 金鑰輪替: 每月"
# Session 3（任何時候，永遠）
你: buddy-do "新增 OAuth"
MeMesh: 🧠 "我看到你有 JWT。讓我們
把 OAuth 整合進去..."https://github.com/user-attachments/assets/a389bcd2-1563-4d91-b363-44cdba5f4e44
💡 自己試試看：
# 在 Claude Code 中
buddy-help # 查看所有指令
buddy-do "解釋 MeMesh 如何運作" # 看它智能回應
buddy-remember "專案決策" # 查詢專案記憶🤔 問題所在
你一定經歷過這種痛苦：
Session 1: "讓我解釋一下我們的架構..."
Session 2: "就像我之前說的，我們的架構..."
Session 3: "我剛剛提到過，我們的架構..."
Session 4: 😤每。一。次。都。要。重複。
✨ 解決方案
❌ 使用 MeMesh 之前
- 每次 session 都要重新解釋架構
- 重複回答相同問題
- 隔天就忘記設計決策
- 一直寫類似的提示詞
- Claude 有失憶症 🤕
✅ 使用 MeMesh 之後
- 記住專案架構
- 瞬間回想過去決策
- 自動整理知識
- 智能路由任務
- Claude 成為你的 AI 隊友 🤝
🎯 核心功能
1. 🧠 真正有用的專案記憶
# Session 1（上週）
你: "我們選擇 PostgreSQL 是因為 JSONB 支援"
# Session 42（今天）
你: buddy-remember "為什麼選 PostgreSQL？"
MeMesh: "根據你在 2024-01-15 的決策：選擇 PostgreSQL 是因為
JSONB 支援和進階查詢能力..."Claude 跨 session 記住了。 （Session 記憶：30 天，專案記憶：90 天）
2. 🎯 智能任務路由（自動駕駛模式）
你: "Review 這段程式碼"
MeMesh: *偵測任務類型*
*啟動程式碼審查模式*
*套用最佳實踐*
*提供結構化審查*不用再問「我該怎麼做？」直接開始做。
3. 💬 超簡單命令
buddy-do "設定身份驗證" # 執行任何開發任務
buddy-remember "API 設計" # 查詢專案記憶
buddy-help # 需要幫助時三個命令。無限可能。
4. 🔐 安全憑證儲存
memesh-secret-store "openai_key" "sk-..." api_key # 加密儲存
memesh-secret-get "openai_key" # 取得憑證
memesh-secret-list # 查看已儲存
memesh-secret-delete "old_key" # 清理舊金鑰AES-256-GCM 加密。本地儲存。取回時透過 MCP tool result 傳輸。
🚀 安裝選項
選擇你偏好的安裝方式：
⚡ npm 全域安裝（最簡單）⭐ 推薦
npm install -g @pcircle/memesh
# 自動設定完成！只需重啟 Claude Code。📦 快速安裝腳本（本地開發用）
git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
./scripts/quick-install.sh🎯 Cursor 使用者
快速安裝（基本功能）：
cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==完整設定：請參閱下方 Cursor 完整設定。
🏆 Claude Code Plugin
claude --plugin-dir /path/to/claude-code-buddy/.claude-plugin/memesh🚀 2 分鐘快速開始
步驟 1：快速安裝
三個簡單命令：
git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
./scripts/quick-install.sh安裝腳本會：
- ✅ 檢查前置需求（Node.js 20+）
- ✅ 安裝相依套件
- ✅ 建置 MeMesh
- ✅ 顯示如何啟動 plugin
然後用以下方式啟動 Claude Code：
claude --plugin-dir /path/to/claude-code-buddy**完成！**MeMesh 現在可以作為 plugin 使用了。
Deep link 提供基本功能。如需完整手動設定：
編輯 Cursor MCP 設定（
~/.cursor/mcp.json或透過 Cursor 設定）：{ "mcpServers": { "memesh": { "command": "npx", "args": ["-y", "@pcircle/memesh"] } } }重啟 Cursor 就完成了。
步驟 2：測試
# 在 Claude Code/Cursor 中輸入：
buddy-help
# 你應該會看到 MeMesh 的命令列表
# 現在試試：
buddy-do "解釋 MeMesh 功能"
# 見證魔法 ✨🎉 就這樣！開始 vibe 吧。
💡 實際使用場景
場景 1：智能任務執行
你: buddy-do "review 身份驗證模組"
MeMesh 路由你的任務...
🔍 偵測到任務類型：程式碼審查
🧠 回想：你過去 session 的身份驗證決策
📋 提供：帶上下文的結構化分析
✅ 結果：
• 根據已儲存的最佳實踐分析了 auth 模組
• 引用了上個月的 JWT 決策
• 基於專案模式提出改善建議
💾 儲存到記憶："Auth review 發現 - 2024-01-20"場景 2：「等等，我們為什麼這樣做？」
你: buddy-remember "身份驗證方式"
MeMesh 立即回想：
📚 3 週前的 JWT vs Session 討論
💻 你寫的實作程式碼
🔧 你決定的錯誤處理模式場景 3：持續開發流程
第 1 天：「實作使用者登入」
↓ MeMesh 記住所有事情
第 5 天：「新增密碼重設」
↓ MeMesh 回想第 1 天的架構
第 10 天：「新增 OAuth 支援」
↓ MeMesh 知道前兩次的設計再也不用重複解釋 context。
📊 MeMesh vs 其他工具
| 功能 | 純 Claude Code | 其他 MCP 工具 | MeMesh | |------|---------------|--------------|-----| | 持久化記憶 | ❌ | ⚠️ 基本功能 | ✅ 完整知識圖譜 | | 智能路由 | ❌ | ❌ | ✅ 自動偵測任務類型 | | Vibe Coding 優化 | ⚠️ | ❌ | ✅ 專為此打造 | | 零設定 | ✅ | ⚠️ 複雜 | ✅ 2 分鐘 | | 免費開源 | ✅ | ⚠️ 不一定 | ✅ AGPL-3.0 |
🛠️ 進階功能
當你使用 buddy-do 時，MeMesh 會自動記錄：
- ✅ 任務目標和結果
- ✅ 技術決策和理由
- ✅ 遇到的錯誤和解決方案
- ✅ 開發里程碑
你不用想記憶的事。MeMesh 會處理。
每個專案都有獨立的記憶空間。
cd ~/project-A
buddy-remember "auth" # 回傳 project-A 的 auth 決策
cd ~/project-B
buddy-remember "auth" # 回傳 project-B 的 auth 決策絕不會混淆。
具備上下文感知的智能記憶檢索：
- 🎯 知識庫語意搜尋
- 🏷️ 自動標籤分類
- 📊 基於上下文的相關性排序
本地優先架構，搭配持久知識圖譜：
- 💾 基於 SQLite 的儲存，支援語意搜尋
- 🔍 向量嵌入實現智慧回憶
- 📡 知識在所有 session 間持久化
安全存儲 API 金鑰和憑證：
- 🔐 AES-256-GCM 加密
- 💾 本地 SQLite 存儲（取回時透過 MCP tool result 傳輸）
- 🔑 使用
memesh-secret-store和memesh-secret-get
完整整合 Model Context Protocol，提供無縫的 Claude Code 體驗。See QUICK_INSTALL.md for the complete tool list.
使用 buddy-help 查看所有可用指令。
🧪 技術細節
需求
- Node.js 20+
- Claude Code 或 Cursor IDE
- 2 分鐘時間
平台支援
- ✅ Claude 4.5（Haiku/Sonnet/Opus）
- ✅ MCP SDK 1.25.3
- ✅ Windows、macOS、Linux
🔒 安全優先
- ✅ 本地優先處理 - 所有資料預設儲存在本地
- ✅ 可選雲端同步 -
memesh-cloud-sync可用於跨裝置記憶（僅在主動啟用時） - ✅ npm audit：0 個漏洞
- ✅ 開源 - 自己審查程式碼
🐛 回報問題 & 獲取協助
遇到問題了嗎？我們來幫忙！
📝 如何回報 Bug
檢查現有 Issues：先看看是否有人已經回報
建立新 Issue：
- 開啟新 Issue
- 請包含：
- ✅ MeMesh 版本（執行
npm list @pcircle/memesh查看） - ✅ Node.js 版本（執行
node --version） - ✅ 作業系統（Windows/macOS/Linux）
- ✅ 錯誤訊息（完整的錯誤 log）
- ✅ 重現步驟
- ✅ MeMesh 版本（執行
緊急問題：如果是安全相關問題，請私下回報至：[email protected]
💬 社群支援
- 一般問題：GitHub Discussions
- 功能建議：Feature Requests
- 疑難排解：閱讀疑難排解指南
🤝 貢獻
我們很樂意你的幫助讓 MeMesh 變得更好！
- 🐛 發現 bug？開啟 issue
- 💡 有想法？開始討論
- 🛠️ **想寫程式？**查看 Good First Issues
貢獻指南：CONTRIBUTING.md
📚 文檔
❓ 常見問題
A： 不用。100% 免費開源（AGPL-3.0）。使用你現有的 Claude Code 訂閱。
A： 是的。所有資料預設在本地處理和儲存。雲端同步（memesh-cloud-sync）可用但需主動啟用 — 未經你明確操作不會上傳任何資料。
A： MeMesh 加入兩大超能力：
- 持久化記憶 - Claude 能跨 session 記住你的專案
- 智能路由 - 自動偵測和處理不同任務類型
可以想成：Claude Code + 超強記憶 + 自動駕駛模式。
A： 當然！MeMesh 外掛程式完全開源。
想更深度客製化？查看我們的貢獻指南或 fork 此專案。
A： 支援！Cursor 原生支援 MCP。在 Cursor 設定中配置 MCP server 路徑即可。
🙏 致謝
站在巨人的肩膀上：
- Model Context Protocol (MCP) - 基礎
- Claude Code - 平台
- 所有我們出色的貢獻者和早期測試者
📄 授權
AGPL-3.0 - 查看 LICENSE
這代表：使用它、修改它、分享它。但保持開源。
🌟 Star 歷史
開發者打造，為開發者服務
別再重複自己。開始 vibe 吧。
⭐ 如果 MeMesh 今天幫你省時間，給它一個 star！
這能幫助其他人發現這個工具。
與 Anthropic PBC 無關 • 獨立開源專案