Context Continue MCP

🚀 Context Continuation MCP Server

AI開発セッションにおいて、インテリジェントなコンテキスト管理を提供するMCP（Model Context Protocol）サーバーです。トークン制限に達してもコンテキストを失うことはありません！

🚀 クイックスタート

📦 インストール

npm install -g context-continue-mcp

Claude Desktopでの使用方法

1. Claude Desktopの設定に追加します：

{
  "mcpServers": {
    "context-continue": {
      "command": "context-mcp",
      "args": ["--project", "/path/to/your/project"]
    }
  }
}

2. Claude Desktopを再起動します。
3. 会話でコンテキストツールを使用します：
   • context_start_session - 新しいセッションのトラッキングを開始します。
   • context_track_message - 重要なメッセージをトラッキングします。
   • context_get_status - トークンの使用状況を確認します。
   • context_restore_session - 復元プロンプトを生成します。

✨ 主な機能

• 自動コンテキストトラッキング：トークンの使用状況と会話の流れを監視します。
• インテリジェントなセッション中断：コンテキスト制限に達する前に通知を受け取ります。
• シームレスな復元：新しいセッション用のコンテキスト復元プロンプトを生成します。
• プロジェクト管理：セッション全体でのマイルストーン、決定事項、進捗状況を追跡します。
• ファイルベースのストレージ：gitと互換性のある人間が読みやすいMarkdownファイルを使用します。

💻 使用例

基本的な使用法

以下はClaude Desktopでの基本的な設定方法です。

{
  "mcpServers": {
    "context-continue": {
      "command": "context-mcp",
      "args": ["--project", "/path/to/your/project"]
    }
  }
}

高度な使用法

会話で利用できる各コマンドの使い方を紹介します。

# 新しいセッションのトラッキングを開始
context_start_session
# 重要なメッセージをトラッキング
context_track_message
# トークンの使用状況を確認
context_get_status
# 復元プロンプトを生成
context_restore_session

📚 ドキュメント

利用可能なツール

セッション管理

• context_start_session - 新しいコンテキストセッションのトラッキングを開始します。
• context_end_session - 現在のセッションを要約付きで終了します。
• context_get_status - 現在のセッションとトークンの使用状況情報を取得します。

コンテキストトラッキング

• context_track_message - セッショントラッキングにメッセージを追加します。
• context_track_progress - プロジェクトの進捗状況を更新します。
• context_add_milestone - プロジェクトのマイルストーンを追加します。

復元

• context_restore_session - コンテキスト復元プロンプトを生成します。
• context_get_project_summary - 完全なプロジェクトの概要を取得します。

動作原理

1. セッションの開始：プロジェクトのコンテキストトラッキングを初期化します。
2. 進捗状況のトラッキング：重要なメッセージと決定事項が自動的に記録されます。
3. 使用状況の監視：トークン制限に近づいたときに警告を受け取ります。
4. シームレスな継続：新しいセッション用の復元プロンプトを生成します。

ファイル構造

サーバーはプロジェクト内に .context ディレクトリを作成します。

your-project/
├── .context/
│   ├── config.json
│   ├── project_summary.md
│   ├── sessions/
│   │   ├── session_001_2025-05-31.md
│   │   └── session_002_2025-06-01.md
│   ├── progress/
│   │   ├── milestones.md
│   │   └── decisions.md
│   └── artifacts/
└── your-code/

品質保証

このプロジェクトは、以下の方法で高いコード品質を維持しています。

• 🧪 包括的なテスト：43以上の単体テストで95％以上のカバレッジを達成しています。
• 🔄 継続的インテグレーション：Node.js 18.x、20.x、21.xで自動テストを行っています。
• 🌍 クロスプラットフォーム：Ubuntu、Windows、macOSでテストされています。
• 📊 コードカバレッジ：Codecovを使用してリアルタイムのカバレッジを追跡しています。
• 🏗️ ビルド検証：自動ビルドとCLI機能のテストを行っています。
• 📦 パッケージ検証：公開前のテストと互換性チェックを行っています。

テストの実行

# すべてのテストを実行
npm test

# カバレッジ付きでテストを実行
npm run test:coverage

# 特定のテストスイートを実行
npm test token-counter
npm test session-tracker
npm test context-manager

# 開発用のウォッチモード
npm run test:watch

開発方法

git clone https://github.com/core3-coder/context-continue-mcp
cd context-continue-mcp
npm install
npm run build
npm start

📄 ライセンス

MIT - 詳細はLICENSEファイルを参照してください。