id: abc123-def456 title: "Code Review Discussion" created_at: 2024-01-15T10:00:00.000Z source_app: Claude tags: ["code-review", "python"]

Code Review Discussion

A discussion about Python best practices

Conversation

User (1/15/2024, 10:00:00 AM)

Can you review this Python function?

Assistant (1/15/2024, 10:00:05 AM)

Sure! Here are my suggestions...

#### JSON
構造化されたJSONファイルを生成します。
```json
{
  "id": "abc123-def456",
  "metadata": {
    "title": "Code Review Discussion",
    "sourceApp": "Claude",
    "createdAt": "2024-01-15T10:00:00.000Z",
    "tags": ["code-review", "python"]
  },
  "messages": [
    {
      "role": "user",
      "content": "Can you review this Python function?",
      "timestamp": "2024-01-15T10:00:00.000Z"
    }
  ]
}

リモートサーバーAPI

リモートストレージを使用する場合、サーバーは次のエンドポイントを実装する必要があります。

POST /conversations

新しい会話を作成します。

リクエストボディ:

{
  "id": "string",
  "title": "string",
  "content": "string (formatted content)",
  "format": "markdown | json",
  "metadata": { ... }
}

レスポンス:

{
  "url": "https://your-server.com/conversations/id"
}

GET /conversations

すべての会話を一覧表示します。

GET /conversations/:id

特定の会話を取得します。

PUT /conversations/:id

会話を更新します（update_thread用）。

DELETE /conversations/:id

会話を削除します。

🔧 技術詳細

前提条件

• Node.js 22+
• npm

セットアップ

npm install

ビルド

npm run build

テストの実行

npm test                 # すべてのテストを実行
npm run test:watch       # ウォッチモード
npm run test:coverage    # カバレッジレポート付き

開発サーバー

npm run dev

リントとフォーマット

npm run lint            # ESLint
npm run format          # Prettierフォーマット
npm run format:check    # フォーマットチェック
npm run typecheck       # TypeScriptの型チェック

プロジェクト構造

thread-mcp/
├── src/
│   ├── index.ts           # エントリーポイント
│   ├── server.ts          # MCPサーバーのセットアップ
│   ├── types.ts           # TypeScriptの型とZodスキーマ
│   ├── tools/             # MCPツールの実装
│   │   ├── save-thread.ts    # 新しいスレッドを保存
│   │   ├── find-threads.ts   # スレッドを検索/一覧表示/取得
│   │   ├── update-thread.ts  # 既存のスレッドを更新
│   │   ├── delete-thread.ts  # スレッドを削除
│   │   └── resume-thread.ts  # 続き用にスレッドをロード
│   ├── formatters/        # 出力フォーマッター
│   │   ├── markdown.ts
│   │   └── json.ts
│   └── storage/           # ストレージプロバイダー
│       ├── local.ts
│       └── remote.ts
├── tests/
│   ├── unit/              # 単体テスト
│   └── e2e/               # エンドツーエンドテスト
├── package.json
├── tsconfig.json
└── vitest.config.ts