@pcircle/claude-code-buddy-mcp

v2.6.3

Published

a day ago

Your friendly AI companion for Claude Code - smart routing, prompt enhancement, and project memory

0High
0Medium
0Low

gjmatw

claude claude-code mcp ai-assistant code-buddy prompt-enhancement smart-routing

🧠 Claude Code Buddy (CCB)

唯一會記住一切的 MCP Server

讓 Claude Code 記住所有事情。開發更快。Vibe 更爽。

🚀 快速開始 • 📖 文檔 • 🌐 官網 • 💬 討論區

🤔 問題所在

你一定經歷過這種痛苦：

Session 1: "讓我解釋一下我們的架構..."
Session 2: "就像我之前說的，我們的架構..."
Session 3: "我剛剛提到過，我們的架構..."
Session 4: 😤

每。一。次。都。要。重複。

✨ 解決方案

❌ 使用 CCB 之前

每次 session 都要重新解釋架構
重複回答相同問題
隔天就忘記設計決策
一直寫類似的提示詞
Claude 有失憶症 🤕

✅ 使用 CCB 之後

記住專案架構
瞬間回想過去決策
自動整理知識
智能路由任務
Claude 成為你的 AI 隊友 🤝

🎯 核心功能

1. 🧠 真正有用的專案記憶

# Session 1（上週）
你: "我們選擇 PostgreSQL 是因為 JSONB 支援"

# Session 42（今天）
你: buddy-remember "為什麼選 PostgreSQL？"
CCB: "根據你在 2024-01-15 的決策：選擇 PostgreSQL 是因為
      JSONB 支援和進階查詢能力..."

Claude 記住了。永遠。

2. 🎯 智能任務路由（自動駕駛模式）

你: "Review 這段程式碼"
CCB: *偵測任務類型*
     *啟動程式碼審查模式*
     *套用最佳實踐*
     *提供結構化審查*

不用再問「我該怎麼做？」直接開始做。

3. 💬 超簡單命令

buddy-do "設定身份驗證"          # 執行任何開發任務
buddy-remember "API 設計"        # 查詢專案記憶
buddy-help                       # 需要幫助時

三個命令。無限可能。

🚀 2 分鐘快速開始

步驟 1：安裝（選擇你的 IDE）

只需點擊這個魔法連結：

cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/claude-code-buddy-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL2NsYXVkZS1jb2RlLWJ1ZGR5LW1jcCJdfQ==

**完成。**重啟 Cursor 就好了。

將這段加到 ~/.claude/mcp_settings.json：

{
  "mcpServers": {
    "@pcircle/claude-code-buddy-mcp": {
      "command": "npx",
      "args": ["-y", "@pcircle/claude-code-buddy-mcp"]
    }
  }
}

重啟 Claude Code 就搞定了。

步驟 2：測試

# 在 Claude Code/Cursor 中輸入：
buddy-help

# 你應該會看到 CCB 的命令列表
# 現在試試：
buddy-do "解釋 CCB 功能"

# 見證魔法 ✨

🎉 就這樣！開始 vibe 吧。

📖 需要幫助？詳細安裝指南 | 疑難排解

💡 實際使用場景

場景 1：開發新功能

你: buddy-do "建立 WebSocket 即時聊天"

CCB 會：
✅ 記住你的技術棧（React, Node.js 等）
✅ 套用你過去的程式碼模式
✅ 生成符合你風格的程式碼
✅ 自動記錄這次設計決策供未來使用

場景 2：「等等，我們為什麼這樣做？」

你: buddy-remember "身份驗證方式"

CCB 立即回想：
📚 3 週前的 JWT vs Session 討論
💻 你寫的實作程式碼
🔧 你決定的錯誤處理模式

場景 3：持續開發流程

第 1 天：「實作使用者登入」
        ↓ CCB 記住所有事情
第 5 天：「新增密碼重設」
        ↓ CCB 回想第 1 天的架構
第 10 天：「新增 OAuth 支援」
        ↓ CCB 知道前兩次的設計

再也不用重複解釋 context。

📊 CCB vs 其他工具

| 功能 | 純 Claude Code | 其他 MCP 工具 | CCB | |------|---------------|--------------|-----| | 持久化記憶 | ❌ | ⚠️ 基本功能 | ✅ 完整知識圖譜 | | 智能路由 | ❌ | ❌ | ✅ 自動偵測任務類型 | | Vibe Coding 優化 | ⚠️ | ❌ | ✅ 專為此打造 | | 零設定 | ✅ | ⚠️ 複雜 | ✅ 2 分鐘 | | 免費開源 | ✅ | ⚠️ 不一定 | ✅ AGPL-3.0 |

🛠️ 進階功能

當你使用 buddy-do 時，CCB 會自動記錄：

✅ 任務目標和結果
✅ 技術決策和理由
✅ 遇到的錯誤和解決方案
✅ 開發里程碑

你不用想記憶的事。CCB 會處理。

每個專案都有獨立的記憶空間。

cd ~/project-A
buddy-remember "auth"  # 回傳 project-A 的 auth 決策

cd ~/project-B
buddy-remember "auth"  # 回傳 project-B 的 auth 決策

絕不會混淆。

完整整合 Model Context Protocol。

查看完整列表：ToolDefinitions.ts

🧪 技術細節

需求

Node.js 20+
Claude Code 或 Cursor IDE
5 分鐘時間

平台支援

✅ Claude 4.5（Haiku/Sonnet/Opus）
✅ MCP SDK 1.25.3
✅ Windows、macOS、Linux

🔒 安全優先

✅ 100% 本地處理 - 資料永不離開你的機器
✅ 零外部 API 呼叫 - 使用你的 Claude Code 訂閱
✅ npm audit：0 個漏洞
✅ 開源 - 自己審查程式碼

🤝 貢獻

我們很樂意你的幫助讓 CCB 變得更好！

🐛 發現 bug？開啟 issue
💡 有想法？開始討論
🛠️ **想寫程式？**查看 Good First Issues

貢獻指南：CONTRIBUTING.md

📚 文檔

❓ 常見問題

A：不用。100% 免費開源（AGPL-3.0）。使用你現有的 Claude Code 訂閱。

A：是的。所有資料都在本地處理。零外部 API 呼叫。零資料上傳。

A： CCB 加入兩大超能力：

持久化記憶 - Claude 能跨 session 記住你的專案
智能路由 - 自動偵測和處理不同任務類型

可以想成：Claude Code + 超強記憶 + 自動駕駛模式。

A：當然。提示詞模板在 src/core/PromptEnhancer.ts。

想更深度客製化？Fork 它、改它、變成你的。這就是開源精神。

A：支援！Cursor 原生支援 MCP。一鍵安裝。

🙏 致謝

站在巨人的肩膀上：

Model Context Protocol (MCP) - 基礎
Claude Code - 平台
所有我們出色的貢獻者和早期測試者

📄 授權

AGPL-3.0 - 查看 LICENSE

這代表：使用它、修改它、分享它。但保持開源。

🌟 Star 歷史

開發者打造，為開發者服務

別再重複自己。開始 vibe 吧。

🚀 開始使用 • 📖 閱讀文檔 • 💬 加入討論

⭐ 如果 CCB 今天幫你省時間，給它一個 star！

這能幫助其他人發現這個工具。

與 Anthropic PBC 無關 • 獨立開源專案

語言：English • 繁體中文