Claude Code Agent MCP Server

🚀 Claude code + n8n + MCP 統合プロジェクト

このプロジェクトは、n8nのワークフロー自動化とClaude CodeおよびModel Context Protocol (MCP)サーバーを統合し、インテリジェントなプロジェクト管理、自動メモリダンプ、AI駆動の開発ワークフローを実現します。

✨ 主な機能

• 🔄 n8nワークフロー自動化：複雑な自動化を行うための視覚的なワークフロービルダー
• 🤖 Claude Code統合：MCPをサポートするAI駆動のコーディングアシスタント
• 💾 永続的メモリシステム：プロジェクトの状態と知識を保存
• 📄 自動ダンプ：毎日の要約とシャットダウン時のバックアップ
• 🎯 ターゲットディレクトリ管理：複数のディレクトリにまたがるコード生成を整理
• 🛠️ 開発ツール：自動化、監視、メンテナンス用のスクリプト
• 🔧 Windows互換：MINGW64/Git Bash環境に最適化

📦 インストール

前提条件

• Node.js 18.0.0以上
• npm 8.0.0以上
• Git
• Claude Pro/Teamサブスクリプション (Claude Code用)
• Windows：Git BashまたはWSL2が推奨

1. インストール

# プロジェクトをクローンまたはダウンロード
git clone <your-repo-url>
cd my-project-n8n

# 依存関係をインストール
npm install

# セットアップスクリプトを実行
./automation/windows-fix.sh    # Windowsユーザー
./setup-targets.sh             # ターゲットディレクトリを設定

2. 環境を構成

# .envファイルを設定で編集
cp .env.example .env
nano .env

# 更新する重要な設定:
# - N8N_API_KEY=your_api_key_here
# - N8N_BASIC_AUTH_PASSWORD=your_password
# - TARGET_PROJECT_DIR=/c/Workspace/MyProject

3. サービスを起動

# n8nを起動
npm run start &

# Claude Codeを認証 (一度だけの設定)
claude auth
claude --dangerously-skip-permissions

# MCPでClaude Codeを起動
claude

4. 設定を確認

# システムの状態を確認
npm run check:dumps

# MCPサーバーをテスト
claude "/mcp"

# コード生成をテスト
claude "Create a simple README.md in the target directory"

💻 使用例

プロジェクト管理

# タスクを追加して進捗を追跡
claude "Add todo: Implement user authentication, high priority, due tomorrow"
claude "Update project status to development with 75% progress"
claude "Record decision: Use PostgreSQL for database with rationale: better performance for complex queries"

# プロジェクトの洞察を取得
claude "Get project overview with details"
claude "What are my next recommended actions?"
claude "Show me all high priority pending tasks"

コード生成

# フロントエンド開発
claude "Create a React UserProfile component with TypeScript in the frontend directory"
claude "Generate a responsive dashboard layout in the frontend/src/pages directory"

# バックエンド開発
claude "Create Express API routes for user CRUD operations in the backend directory"
claude "Generate Mongoose models for User and Product in the backend/models directory"

# フルスタック機能
claude "Create a complete authentication system with React frontend, Express backend, and shared TypeScript types"

n8nワークフロー統合

# ワークフローのドキュメント
claude "Show me available n8n nodes for HTTP requests"
claude "Create a workflow that triggers when a GitHub issue is created and sends a Slack notification"

# ワークフロー管理
claude "List all n8n workflows and their status"
claude "Export the user-registration workflow to the workflows directory"

メモリ管理

# 手動ダンプ
claude "Create memory dump with type full"
claude "Create daily summary with metrics and tomorrow's plan"

# 検索と洞察
claude "Search memory for 'authentication' across all types"
claude "What decisions have we made about the database?"
claude "Show me recent learnings from the past week"

📚 ドキュメント

APIドキュメント

• n8n API：http://localhost:5678/rest/でアクセス
• MCPプロトコル：Model Context Protocol Docs
• Claude Code：Claude Code Documentation

設定ファイル

• .env：環境変数と設定
• .mcp.json：MCPサーバーの設定
• package.json：依存関係とスクリプト
• プロジェクトメモリ：project-memory.jsonに保存

生成されるファイル

• メモリダンプ：memory-dumps/内のMarkdownファイル
• バックアップ：backups/内の圧縮JSONファイル
• ログ：logs/内の操作ログ
• ワークフロー：workflows/内のn8nエクスポートファイル

🔧 技術詳細

環境変数 (.env)

# プロジェクト設定
PROJECT_NAME=My Awesome Project
PROJECT_VERSION=1.0.0

# n8n設定
N8N_HOST=http://localhost:5678
N8N_API_KEY=your_api_key_here
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=your_secure_password

# コード生成ターゲット
TARGET_PROJECT_DIR=/c/Workspace/MyProject
FRONTEND_DIR=/c/Workspace/MyProject/frontend
BACKEND_DIR=/c/Workspace/MyProject/backend
SHARED_DIR=/c/Workspace/MyProject/shared

# メモリとダンプ
MEMORY_FILE=./project-memory.json
DUMP_DIR=./memory-dumps
BACKUP_DIR=./backups
AUTO_DUMP=true

# 自動化
CRON_ENABLED=true
DAILY_DUMP_TIME=18:00
BACKUP_INTERVAL=4h
CLEANUP_DAYS=30

# ロギング
LOG_LEVEL=info
LOG_FILE=./logs/project.log

MCPサーバー (.mcp.json)

{
  "mcpServers": {
    "memory-dump": {
      "command": "node",
      "args": ["./mcp-servers/memory-dump-server.js"],
      "env": {
        "MEMORY_FILE": "./project-memory.json",
        "DUMP_DIR": "./memory-dumps",
        "AUTO_DUMP": "true"
      }
    },
    "filesystem-target": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${TARGET_PROJECT_DIR}"],
      "env": {}
    },
    "filesystem-current": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"],
      "env": {}
    }
  }
}

利用可能なスクリプト

# n8n管理
npm run start                    # n8nサーバーを起動
npm run start:docker            # Dockerで起動
npm run stop:docker             # Dockerコンテナを停止

# Claude Code
npm run claude                   # Claude Codeを起動
npm run test:mcp                 # MCPサーバーの接続をテスト

# メモリとダンプ
npm run dump:manual             # 手動でメモリダンプを作成
npm run dump:daily              # 毎日の要約を作成
npm run dump:shutdown           # シャットダウン時のダンプを作成

# システム管理
npm run check:dumps             # システムの状態を確認
npm run setup:cron              # 自動化を設定 (Linux/Mac)
npm run change-target           # ターゲットディレクトリを変更
npm run test:targets            # ターゲットディレクトリのアクセスをテスト

# ログ
npm run logs:n8n               # n8nのログを表示
npm run logs:project           # プロジェクトのログを表示

MCPサーバーの機能

メモリダンプサーバー

• プロジェクト状態管理：フェーズ、進捗、マイルストーンを追跡
• Todo管理：優先度を付けてタスクを追加、更新、完了
• 知識ベース：決定、学習、洞察を記録
• 自動ダンプシステム：イベント時に自動的にメモリを保存
• 検索と分析：プロジェクト履歴全体で情報を検索

ファイルシステムサーバー

• 複数ディレクトリアクセス：異なるプロジェクト領域をターゲットにする
• 整理されたコード生成：フロントエンド、バックエンド、共有コード
• ファイル操作：ファイルの読み取り、書き込み、検索、管理
• プロジェクト構造：整理されたディレクトリ階層を維持

自動化機能

毎日の自動化

• 18:00：毎日の要約生成
• 23:30：完全なメモリダンプとバックアップ
• 4時間ごと：増分バックアップ (平日)
• 毎週：包括的なプロジェクトレポート

イベントトリガーダンプ

• タスク完了：タスクが完了したときに自動ダンプ
• マイルストーン達成：マイルストーン達成時に包括的なダンプ
• シャットダウン検出：システムシャットダウン時に緊急ダンプ
• エラー回復：重大なエラー時にバックアップを作成

クリーンアップとメンテナンス

• ログローテーション：自動的なログファイル管理
• バックアップクリーンアップ：30日以上古いバックアップを削除
• メモリ最適化：古いダンプとバックアップを圧縮
• ヘルスモニタリング：システムの状態をチェックしてアラートを発する

開発ワークフロー

日常の開発

# 朝：プロジェクトの状態を確認
npm run check:dumps
claude "Get project overview and next actions"

# 開発：AIアシスタントを使用
claude "Add todo: Implement password reset feature"
claude "Create React component for password reset form"

# 夕方：レビューとダンプ
claude "Update project status with today's progress"
npm run dump:daily

機能開発

# 計画
claude "Add upcoming feature: Real-time notifications with medium priority"
claude "Break down the implementation steps for real-time notifications"

# 実装
claude "Create WebSocket server in backend for real-time features"
claude "Generate React hooks for WebSocket connection in frontend"

# 完了
claude "Complete task with notes: Real-time notifications implemented successfully"
claude "Record learning: WebSocket implementation requires careful connection management"

チームコラボレーション

# ドキュメント作成
claude "Create API documentation for the authentication endpoints"
claude "Generate team update report for the past sprint"

# 知識共有
claude "Record decision: Use Redis for session storage with rationale and alternatives"
claude "Export project report for stakeholder meeting"

🚨 トラブルシューティング

一般的な問題

MCPサーバーに接続できない

# MCPの状態を確認
claude "/mcp"

# Claude Codeを再起動
# プロジェクトディレクトリで終了して再起動
cd /path/to/project
claude

n8nにアクセスできない

# n8nが実行中か確認
curl http://localhost:5678/rest/health

# n8nを再起動
npm run start

ファイルパーミッションの問題

# スクリプトのパーミッションを修正
chmod +x automation/*.sh
chmod +x mcp-servers/*.js

# ディレクトリのパーミッションを修正
chmod 755 memory-dumps backups logs

Windowsのパスの問題

# Windowsの修正スクリプトを実行
./automation/windows-fix.sh

# パスを手動で変換
# C:\Workspace\Project -> /c/Workspace/Project

デバッグ情報

# システムチェック
./automation/check-dumps.sh

# ログを表示
tail -f logs/project.log
tail -f logs/dump.log

# 個々のコンポーネントをテスト
node mcp-servers/memory-dump-server.js
curl http://localhost:5678/rest/health

🤝 コントリビューション

新しいMCPサーバーの追加

1. mcp-servers/ディレクトリにサーバーを作成
2. .mcp.jsonに設定を追加
3. ドキュメントを更新
4. Claude Codeでテスト

自動化の拡張

1. automation/ディレクトリにスクリプトを追加
2. package.jsonのスクリプトを更新
3. READMEに使用方法を記載
4. ターゲットプラットフォームでテスト

メモリシステムの改善

1. メモリダンプサーバーの機能を拡張
2. 新しいツール関数を追加
3. 自動ダンプトリガーを更新
4. 検索と分析を強化

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

🆘 サポート

ヘルプの取得

1. ドキュメントを確認：このREADMEとインラインコメントを確認
2. 診断を実行：npm run check:dumpsとデバッグスクリプトを使用
3. ログを確認：logs/ディレクトリ内のログを確認
4. コミュニティリソース：
   • n8nコミュニティ
   • Anthropic Discord
   • MCP GitHub

問題の報告

問題を報告する際には、以下を含めてください：

• システム情報 (OS、Node.jsバージョン)
• エラーメッセージとログ
• 再現手順
• 設定ファイル (機密データを除く)

機能リクエスト

改善の提案：

• 新しいMCPサーバー機能
• 追加の自動化機能
• より良いWindows互換性
• 強化されたドキュメント

🎉 謝辞

• Anthropic：Claude CodeとMCPプロトコルの提供
• n8n：優れたワークフロー自動化プラットフォームの提供
• コミュニティ貢献者：MCPサーバーとツールの提供
• オープンソースライブラリ：この統合を可能にしている

Happy Coding! 🚀

n8n、Claude Code、MCPを使って❤️で構築されました