コンテキストマネージャーMCPサーバー
開発コンテキストとワークフローを管理するためのモデル コンテキスト プロトコル (MCP) サーバー実装。
特徴
- 信頼性の高いメッセージフレーミングを備えたソケットベースのトランスポート
- JSON-RPC 2.0プロトコルの完全サポート
- 機能ネゴシエーションによるセッション管理
- 拡張可能なツールレジストリシステム
- プロジェクト、作業パッケージ、タスク管理
- チェックポイントと復元機能
- QAレビューワークフローのサポート
初期設定
# Install dependencies
npm install
# First-time build
npm run build
使用法
サーバーの起動
# Development mode (no build required, uses tsx for on-the-fly compilation)
npm run dev
# Production mode (requires build)
npm start
# Start with debug logging
DEBUG=1 npm run dev
# Start on specific port
MCP_PORT=44558 npm run dev
開発モード
# Run with hot reloading (preferred during development)
npm run dev
# Watch mode for TypeScript compilation (if you prefer running the compiled version)
npm run watch
# In a separate terminal when using watch mode
npm start
クリーンスタート
問題が発生した場合は、クリーン ビルドを試すことができます。
# Remove build artifacts
rm -rf dist/
# Reinstall dependencies
npm ci
# Rebuild the project
npm run build
# Start in development mode
npm run dev
建築
コアコンポーネント
- メッセージフレーミング
- コンテンツ長ベースのプロトコル
- 信頼性の高いメッセージ境界処理
- バッファ管理
- トランスポート層
- TCPソケットベースの通信
- 接続管理
- イベント駆動型アーキテクチャ
- セッション管理
- ツールレジストリ
ツール
- プロジェクト管理
- プロジェクトの作成/取得
- プロジェクトチェックポイント
- 国家の回復
- 作業パッケージ管理
- 作業パッケージの作成/取得
- 進捗状況の追跡
- ステータスの更新
- タスク管理
- タスクの作成/更新
- ファイル変更追跡
- タスクのチェックポイント
- QAツール
- レビューワークフロー
- 修正リクエスト
- 作業パッケージの承認
構成
環境変数:
DEBUG
: デバッグログを有効にする (0/1)MCP_PORT
: サーバーポート (デフォルト: 44557)
プロトコル
サーバーは JSON-RPC 2.0 を使用してモデル コンテキスト プロトコルを実装します。
interface MCPMessage {
jsonrpc: "2.0";
id: number;
method?: string; // for requests
params?: any; // for requests
result?: any; // for responses
error?: { // for error responses
code: number;
message: string;
data?: any;
};
}
メッセージフロー
- クライアントはTCP経由で接続します
- クライアントが初期化要求を送信する
- サーバーは機能で応答します
- 通常のメッセージ交換が始まる
- クライアントはシャットダウン/終了できます
発達
上記の初期設定と開発モードのセクションを参照してください。
貢献
- リポジトリをフォークする
- 機能ブランチを作成する
- 変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する
ライセンス
ISCライセンス