@ebowwa/claudecodehistory 1.5.0 → 1.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ebowwa/claudecodehistory",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "TypeScript library for accessing and analyzing Claude Code conversation history",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,6 @@
   },
   "files": [
     "dist/",
-    "example/",
     "README",
     "README.md",
     "LICENSE"

package/example/README.md

@@ -1,79 +0,0 @@
-# Claude Code History MCP Server - Example
-
-This is an example MCP server that demonstrates how to use the `@ebowwa/claudecodehistory` library to create an MCP server for Claude Code conversation history.
-
-## About This Example
-
-This example shows how to:
-- Use the `ClaudeCodeHistoryService` class from the library
-- Wrap it in an MCP server using the Model Context Protocol SDK
-- Expose the service's functionality as MCP tools
-
-## Features
-
-This MCP server provides **4 powerful tools** for exploring your Claude Code conversation history:
-
-### 1. `list_projects`
-Discover all projects with Claude Code conversation history.
-
-### 2. `list_sessions`
-List conversation sessions for exploration and filtering.
-
-### 3. `get_conversation_history`
-Retrieve paginated conversation history with smart filtering.
-
-### 4. `search_conversations`
-Search across all conversation content by keywords.
-
-## Quick Start
-
-```bash
-# From the example directory
-cd example
-
-# Install dependencies (uses bun)
-bun install
-
-# Run directly
-bun src/index.ts
-```
-
-## Usage with MCP Clients
-
-Add the following configuration to your MCP client (e.g., Claude Desktop):
-
-```json
-{
-  "mcpServers": {
-    "claude-code-history": {
-      "command": "bun",
-      "args": ["/path/to/claude-code-history-mcp/example/src/index.ts"]
-    }
-  }
-}
-```
-
-## Development
-
-- **Runtime:** `bun` (no build step required)
-- **TypeScript:** Executed directly via bun
-- **Hot reload:** `bun --hot src/index.ts`
-
-## Library Dependency
-
-This example imports from `@ebowwa/claudecodehistory` (the parent package):
-
-```typescript
-import { ClaudeCodeHistoryService } from '@ebowwa/claudecodehistory';
-```
-
-The service provides all the core functionality for accessing Claude Code history:
-
-- `getConversationHistory()` - Get paginated conversation history
-- `searchConversations()` - Search by content
-- `listProjects()` - List all projects
-- `listSessions()` - List sessions with filters
-
-## License
-
-MIT

package/example/package.json

@@ -1,37 +0,0 @@
-{
-  "name": "@ebowwa/claude-code-history-example",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "claude-code-history-mcp": "src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun --hot src/index.ts",
-    "start": "bun src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@ebowwa/claudecodehistory": "file:..",
-    "@modelcontextprotocol/sdk": "^1.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.4",
-    "typescript": "^5.8.3"
-  },
-  "keywords": [
-    "claude-code",
-    "mcp",
-    "history",
-    "conversation",
-    "example",
-    "typescript",
-    "bun"
-  ],
-  "author": "ebowwa",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}

package/example/src/index.js

@@ -1,275 +0,0 @@
-#!/usr/bin/env bun
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-var index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
-var stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-var types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-var claudecodehistory_1 = require("@ebowwa/claudecodehistory");
-var server = new index_js_1.Server({
-    name: 'claude-code-history-mcp',
-    version: '1.1.0',
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-var historyService = new claudecodehistory_1.ClaudeCodeHistoryService();
-// Helper function to create response
-var createResponse = function (data) { return ({
-    content: [{
-            type: 'text',
-            text: JSON.stringify(data),
-        }],
-}); };
-// Define available tools (ordered by recommended workflow)
-var tools = [
-    {
-        name: 'list_projects',
-        description: 'List all projects with Claude Code conversation history (start here to explore available data)',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'list_sessions',
-        description: 'List conversation sessions for a project or date range (use after list_projects to find specific sessions)',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                projectPath: {
-                    type: 'string',
-                    description: 'Filter by specific project path (optional)',
-                },
-                startDate: {
-                    type: 'string',
-                    description: 'Start date in ISO format (optional)',
-                },
-                endDate: {
-                    type: 'string',
-                    description: 'End date in ISO format (optional)',
-                },
-                timezone: {
-                    type: 'string',
-                    description: 'Timezone for date filtering (e.g., "Asia/Tokyo", "UTC"). Defaults to system timezone.',
-                },
-            },
-        },
-    },
-    {
-        name: 'get_conversation_history',
-        description: 'Get paginated conversation history (use after exploring with list_projects/list_sessions for targeted data)',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sessionId: {
-                    type: 'string',
-                    description: 'Specific session ID to get history for (optional)',
-                },
-                startDate: {
-                    type: 'string',
-                    description: 'Start date in ISO format (optional)',
-                },
-                endDate: {
-                    type: 'string',
-                    description: 'End date in ISO format (optional)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum number of conversations to return (default: 20)',
-                    default: 20,
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Number of conversations to skip for pagination (default: 0)',
-                    default: 0,
-                },
-                messageTypes: {
-                    type: 'array',
-                    items: {
-                        type: 'string',
-                        enum: ['user', 'assistant', 'system', 'result']
-                    },
-                    description: 'Filter by specific message types. Defaults to ["user"] to reduce data volume. Use ["user", "assistant"] to include Claude responses.',
-                    default: ['user']
-                },
-                timezone: {
-                    type: 'string',
-                    description: 'Timezone for date filtering (e.g., "Asia/Tokyo", "UTC"). Defaults to system timezone.',
-                },
-            },
-        },
-    },
-    {
-        name: 'search_conversations',
-        description: 'Search through conversation history by content (useful for finding specific topics across all conversations)',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: {
-                    type: 'string',
-                    description: 'Search query to find in conversation content',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum number of results to return (default: 30)',
-                    default: 30,
-                },
-                projectPath: {
-                    type: 'string',
-                    description: 'Filter by specific project path (optional)',
-                },
-                startDate: {
-                    type: 'string',
-                    description: 'Start date in ISO format (optional)',
-                },
-                endDate: {
-                    type: 'string',
-                    description: 'End date in ISO format (optional)',
-                },
-                timezone: {
-                    type: 'string',
-                    description: 'Timezone for date filtering (e.g., "Asia/Tokyo", "UTC"). Defaults to system timezone.',
-                },
-            },
-            required: ['query'],
-        },
-    },
-];
-// Handle list tools request
-server.setRequestHandler(types_js_1.ListToolsRequestSchema, function () { return __awaiter(void 0, void 0, void 0, function () {
-    return __generator(this, function (_a) {
-        return [2 /*return*/, { tools: tools }];
-    });
-}); });
-// Handle tool calls
-server.setRequestHandler(types_js_1.CallToolRequestSchema, function (request) { return __awaiter(void 0, void 0, void 0, function () {
-    var _a, name, args, _b, history_1, query, results, projects, sessions, error_1, errorMessage;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
-            case 0:
-                _a = request.params, name = _a.name, args = _a.arguments;
-                _c.label = 1;
-            case 1:
-                _c.trys.push([1, 12, , 13]);
-                _b = name;
-                switch (_b) {
-                    case 'get_conversation_history': return [3 /*break*/, 2];
-                    case 'search_conversations': return [3 /*break*/, 4];
-                    case 'list_projects': return [3 /*break*/, 6];
-                    case 'list_sessions': return [3 /*break*/, 8];
-                }
-                return [3 /*break*/, 10];
-            case 2: return [4 /*yield*/, historyService.getConversationHistory({
-                    sessionId: args === null || args === void 0 ? void 0 : args.sessionId,
-                    startDate: args === null || args === void 0 ? void 0 : args.startDate,
-                    endDate: args === null || args === void 0 ? void 0 : args.endDate,
-                    limit: (args === null || args === void 0 ? void 0 : args.limit) || 20,
-                    offset: (args === null || args === void 0 ? void 0 : args.offset) || 0,
-                    messageTypes: args === null || args === void 0 ? void 0 : args.messageTypes,
-                    timezone: args === null || args === void 0 ? void 0 : args.timezone,
-                })];
-            case 3:
-                history_1 = _c.sent();
-                return [2 /*return*/, createResponse(history_1)];
-            case 4:
-                query = args === null || args === void 0 ? void 0 : args.query;
-                if (!query) {
-                    throw new Error('Search query is required');
-                }
-                return [4 /*yield*/, historyService.searchConversations(query, {
-                        limit: (args === null || args === void 0 ? void 0 : args.limit) || 30,
-                        projectPath: args === null || args === void 0 ? void 0 : args.projectPath,
-                        startDate: args === null || args === void 0 ? void 0 : args.startDate,
-                        endDate: args === null || args === void 0 ? void 0 : args.endDate,
-                        timezone: args === null || args === void 0 ? void 0 : args.timezone,
-                    })];
-            case 5:
-                results = _c.sent();
-                return [2 /*return*/, createResponse(results)];
-            case 6: return [4 /*yield*/, historyService.listProjects()];
-            case 7:
-                projects = _c.sent();
-                return [2 /*return*/, createResponse(projects)];
-            case 8: return [4 /*yield*/, historyService.listSessions({
-                    projectPath: args === null || args === void 0 ? void 0 : args.projectPath,
-                    startDate: args === null || args === void 0 ? void 0 : args.startDate,
-                    endDate: args === null || args === void 0 ? void 0 : args.endDate,
-                    timezone: args === null || args === void 0 ? void 0 : args.timezone,
-                })];
-            case 9:
-                sessions = _c.sent();
-                return [2 /*return*/, createResponse(sessions)];
-            case 10: throw new Error("Unknown tool: ".concat(name));
-            case 11: return [3 /*break*/, 13];
-            case 12:
-                error_1 = _c.sent();
-                errorMessage = error_1 instanceof Error ? error_1.message : 'Unknown error';
-                return [2 /*return*/, {
-                        content: [{
-                                type: 'text',
-                                text: "Error: ".concat(errorMessage),
-                            }],
-                        isError: true,
-                    }];
-            case 13: return [2 /*return*/];
-        }
-    });
-}); });
-// Start the server
-function main() {
-    return __awaiter(this, void 0, void 0, function () {
-        var transport;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    transport = new stdio_js_1.StdioServerTransport();
-                    return [4 /*yield*/, server.connect(transport)];
-                case 1:
-                    _a.sent();
-                    console.error('Claude Code History MCP Server started');
-                    return [2 /*return*/];
-            }
-        });
-    });
-}
-main().catch(function (error) {
-    console.error('Failed to start server:', error);
-    process.exit(1);
-});

package/example/src/index.ts

@@ -1,233 +0,0 @@
-#!/usr/bin/env bun
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  Tool
-} from '@modelcontextprotocol/sdk/types.js';
-import { ClaudeCodeHistoryService } from '@ebowwa/claudecodehistory';
-
-const server = new Server(
-  {
-    name: 'claude-code-history-mcp',
-    version: '1.1.0',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
-  }
-);
-
-const historyService = new ClaudeCodeHistoryService();
-
-// Helper function to create response
-const createResponse = (data: any) => ({ // eslint-disable-line @typescript-eslint/no-explicit-any
-  content: [{
-    type: 'text',
-    text: JSON.stringify(data),
-  }],
-});
-
-// Define available tools (ordered by recommended workflow)
-const tools: Tool[] = [
-  {
-    name: 'list_projects',
-    description: 'List all projects with Claude Code conversation history (start here to explore available data)',
-    inputSchema: {
-      type: 'object',
-      properties: {},
-    },
-  },
-  {
-    name: 'list_sessions',
-    description: 'List conversation sessions for a project or date range (use after list_projects to find specific sessions)',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        projectPath: {
-          type: 'string',
-          description: 'Filter by specific project path (optional)',
-        },
-        startDate: {
-          type: 'string',
-          description: 'Start date in ISO format (optional)',
-        },
-        endDate: {
-          type: 'string',
-          description: 'End date in ISO format (optional)',
-        },
-        timezone: {
-          type: 'string',
-          description: 'Timezone for date filtering (e.g., "Asia/Tokyo", "UTC"). Defaults to system timezone.',
-        },
-      },
-    },
-  },
-  {
-    name: 'get_conversation_history',
-    description: 'Get paginated conversation history (use after exploring with list_projects/list_sessions for targeted data)',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        sessionId: {
-          type: 'string',
-          description: 'Specific session ID to get history for (optional)',
-        },
-        startDate: {
-          type: 'string',
-          description: 'Start date in ISO format (optional)',
-        },
-        endDate: {
-          type: 'string',
-          description: 'End date in ISO format (optional)',
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum number of conversations to return (default: 20)',
-          default: 20,
-        },
-        offset: {
-          type: 'number',
-          description: 'Number of conversations to skip for pagination (default: 0)',
-          default: 0,
-        },
-        messageTypes: {
-          type: 'array',
-          items: {
-            type: 'string',
-            enum: ['user', 'assistant', 'system', 'result']
-          },
-          description: 'Filter by specific message types. Defaults to ["user"] to reduce data volume. Use ["user", "assistant"] to include Claude responses.',
-          default: ['user']
-        },
-        timezone: {
-          type: 'string',
-          description: 'Timezone for date filtering (e.g., "Asia/Tokyo", "UTC"). Defaults to system timezone.',
-        },
-      },
-    },
-  },
-  {
-    name: 'search_conversations',
-    description: 'Search through conversation history by content (useful for finding specific topics across all conversations)',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        query: {
-          type: 'string',
-          description: 'Search query to find in conversation content',
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum number of results to return (default: 30)',
-          default: 30,
-        },
-        projectPath: {
-          type: 'string',
-          description: 'Filter by specific project path (optional)',
-        },
-        startDate: {
-          type: 'string',
-          description: 'Start date in ISO format (optional)',
-        },
-        endDate: {
-          type: 'string',
-          description: 'End date in ISO format (optional)',
-        },
-        timezone: {
-          type: 'string',
-          description: 'Timezone for date filtering (e.g., "Asia/Tokyo", "UTC"). Defaults to system timezone.',
-        },
-      },
-      required: ['query'],
-    },
-  },
-];
-
-// Handle list tools request
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return { tools };
-});
-
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  try {
-    switch (name) {
-      case 'get_conversation_history': {
-        const history = await historyService.getConversationHistory({
-          sessionId: args?.sessionId as string,
-          startDate: args?.startDate as string,
-          endDate: args?.endDate as string,
-          limit: (args?.limit as number) || 20,
-          offset: (args?.offset as number) || 0,
-          messageTypes: args?.messageTypes as ('user' | 'assistant' | 'system' | 'result')[],
-          timezone: args?.timezone as string,
-        });
-        return createResponse(history);
-      }
-
-      case 'search_conversations': {
-        const query = args?.query as string;
-        if (!query) {
-          throw new Error('Search query is required');
-        }
-
-        const results = await historyService.searchConversations(
-          query,
-          {
-            limit: (args?.limit as number) || 30,
-            projectPath: args?.projectPath as string,
-            startDate: args?.startDate as string,
-            endDate: args?.endDate as string,
-            timezone: args?.timezone as string,
-          }
-        );
-        return createResponse(results);
-      }
-
-      case 'list_projects': {
-        const projects = await historyService.listProjects();
-        return createResponse(projects);
-      }
-
-      case 'list_sessions': {
-        const sessions = await historyService.listSessions({
-          projectPath: args?.projectPath as string,
-          startDate: args?.startDate as string,
-          endDate: args?.endDate as string,
-          timezone: args?.timezone as string,
-        });
-        return createResponse(sessions);
-      }
-
-      default:
-        throw new Error(`Unknown tool: ${name}`);
-    }
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-    return {
-      content: [{
-        type: 'text',
-        text: `Error: ${errorMessage}`,
-      }],
-      isError: true,
-    };
-  }
-});
-
-// Start the server
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('Claude Code History MCP Server started');
-}
-
-main().catch((error) => {
-  console.error('Failed to start server:', error);
-  process.exit(1);
-});

package/example/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "noEmit": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}