{"id":31581029,"url":"https://github.com/bwads001/cc-session-search","last_synced_at":"2026-04-29T16:32:44.707Z","repository":{"id":314547522,"uuid":"1055941788","full_name":"bwads001/cc-session-search","owner":"bwads001","description":"MCP server for searching and analyzing Claude Code conversation history","archived":false,"fork":false,"pushed_at":"2025-09-20T23:15:40.000Z","size":34,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-05T21:55:27.762Z","etag":null,"topics":["ai-tools","claude-ai","claude-code","conversation-analysis","knowledge-management","mcp","mcp-server","model-context-protocol"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bwads001.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-13T04:47:36.000Z","updated_at":"2025-09-20T23:15:44.000Z","dependencies_parsed_at":"2025-09-13T06:32:47.682Z","dependency_job_id":"4e5c4893-2907-443c-9e6e-669bf13e899a","html_url":"https://github.com/bwads001/cc-session-search","commit_stats":null,"previous_names":["bwads001/cc-session-search"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bwads001/cc-session-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bwads001%2Fcc-session-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bwads001%2Fcc-session-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bwads001%2Fcc-session-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bwads001%2Fcc-session-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bwads001","download_url":"https://codeload.github.com/bwads001/cc-session-search/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bwads001%2Fcc-session-search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32434784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude-ai","claude-code","conversation-analysis","knowledge-management","mcp","mcp-server","model-context-protocol"],"created_at":"2025-10-05T21:52:19.106Z","updated_at":"2026-04-29T16:32:44.688Z","avatar_url":"https://github.com/bwads001.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Session Search MCP Server\n\nAn MCP (Model Context Protocol) server that provides tools for searching and analyzing Claude Code conversation history.\n\n## Features\n\n- **List Projects**: View all Claude Code projects with session counts\n- **List Sessions**: Browse sessions for specific projects\n- **List Recent Sessions**: Find recent conversations across all projects\n- **Analyze Sessions**: Extract and analyze messages with role filtering\n- **Search Conversations**: Search for specific terms with context windows and time ranges\n- **Get Message Details**: Retrieve full content for specific messages\n- **Summarize Conversations**: AI-powered summarization of daily conversations\n\n## Installation\n\n1. Install dependencies:\n```bash\nuv sync\n```\n\n2. Run the server:\n```bash\nuv run python server.py\n```\n\n3. Add to Claude Code MCP config (`~/.config/claude/mcp.json`):\n```json\n{\n  \"servers\": {\n    \"cc-session-search\": {\n      \"command\": [\"uv\", \"run\", \"python\", \"server.py\"],\n      \"cwd\": \"/path/to/cc-session-search\"\n    }\n  }\n}\n```\n\n## Requirements\n\n- Standard Claude Code installation (searches `~/.claude/projects/`)\n- Python 3.13+\n- MCP 1.2.0+\n\n## Usage\n\nThe server provides the following tools:\n\n### list_projects()\nLists all Claude Code projects with session counts and recent activity.\n\n### list_sessions(project_name, days_back=7)\nLists sessions for a specific project within the specified time range.\n\n### list_recent_sessions(days_back=1, project_filter=None)\nLists recent sessions across all projects.\n\n### analyze_sessions(days_back=1, role_filter=\"both\", include_tools=False, project_filter=None)\nExtracts and analyzes messages from sessions with filtering options.\n\n### search_conversations(query, days_back=2, context_window=1, case_sensitive=False, project_filter=None)\nSearches conversations for specific terms with context windows.\n\n### get_message_details(session_id, message_indices)\nRetrieves full content for specific messages by session ID and indices.\n\n## Development\n\nThe server is built using the official MCP Python SDK with low-level Server class for maximum control.\n\nKey features:\n- Efficient response handling with content truncation\n- Metadata-first approach to minimize token usage\n- Support for date ranges and filtering\n- Cross-project search capabilities\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbwads001%2Fcc-session-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbwads001%2Fcc-session-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbwads001%2Fcc-session-search/lists"}