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