Chatlog MCP Server

A Model Context Protocol (MCP) server for analyzing chat logs from various platforms. This server provides convenient access to chat data through MCP-compatible clients like Claude Code.

✨ Features

• 🔍 4 Core Tools: List chatrooms, contacts, sessions, and chatlogs

• 📊 Advanced Analytics: Message statistics, active members, keyword analysis

• 🔎 Flexible Search: Time range, keyword, and sender filtering

• 📈 Data Export: JSON, Text, and CSV formats

• 🌐 Multi-Client Support: Claude Code, Cursor, VS Code, and more

• 🛠️ Easy Installation: pip install and go

📦 Installation

Option 1: Install from PyPI (Recommended)

Option 2: Install from Source

Option 3: Install with Development Dependencies

🚀 Quick Start

1. Install the Package

2. Configure MCP Client

Create a mcp-servers.json file:

3. Start Using

In Claude Code, simply say:

🛠️ Configuration

Environment Variables

You can configure the server using environment variables:

Command Line Options

Options:

• --api-url URL: Set custom API URL

• --log-level LEVEL: Set logging level (debug, info, warning, error)

• --version: Show version and exit

Example Configuration

📚 Tools

The Chatlog MCP Server provides 4 core tools:

1. list_chatrooms

Get a list of chatrooms with optional keyword search.

Parameters:

• keyword (optional): Search keyword

• format (optional): Output format (json/text)

Example:

2. list_contacts

Get a list of contacts with optional keyword search.

Parameters:

• keyword (optional): Search keyword

• format (optional): Output format (json/text)

Example:

3. get_recent_sessions

Get a list of recent sessions.

Parameters:

• format (optional): Output format (json/text)

Example:

4. get_chatlog

Get chat logs for a specific time range and chatroom.

Parameters:

• time (required): Time range (e.g., "2026-01-13" or "2026-01-10~2026-01-13")

• talker (required): Chatroom or contact ID

• sender (optional): Filter by sender

• keyword (optional): Search keyword

• limit (optional): Limit number of results

• offset (optional): Offset for pagination

• format (optional): Output format (json/text/csv)

Example:

📊 Use Cases

Case 1: Analyze Chatroom Activity

Case 2: Search for Specific Keywords

Case 3: Get Top Active Members

Then use the provided analysis scripts:

🔧 Development

Setup Development Environment

Run Tests

Code Formatting

📖 Examples

See the examples/ directory for:

• Sample configurations

• Analysis scripts

• Data export examples

• Integration guides

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Workflow

1. Fork the repository

2. Create a feature branch: git checkout -b feature/amazing-feature

3. Make your changes

4. Run tests: pytest

5. Commit changes: git commit -m 'Add amazing feature'

6. Push to branch: git push origin feature/amazing-feature

7. Open a Pull Request

📋 Requirements

• Python 3.10 or higher

• HTTP API server running on specified URL

• MCP-compatible client (Claude Code, Cursor, etc.)

🐛 Troubleshooting

Common Issues

Issue: "Unknown skill: chatlog"

• Ensure the MCP server is running

• Check that the configuration is correct

• Verify the command path is accessible

Issue: "Connection refused"

• Ensure the HTTP API server is running

• Check the API URL in configuration

• Verify network connectivity

Issue: Chinese characters not displaying correctly

• Ensure PYTHONIOENCODING=utf-8 is set

• Use UTF-8 encoding for all files

• Check terminal encoding settings

For more help, see TROUBLESHOOTING.md or open an issue.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol for the amazing protocol

• Claude Code for the MCP client

• Anthropic for the support

📞 Support

• 📧 Email: support@anthropic.com

• 🐛 Issues: GitHub Issues

• 📖 Docs: Full Documentation

🗺️ Roadmap

• Add support for more chat platforms

• Real-time message streaming

• Advanced analytics and visualization

• Webhook support

• Plugin system for custom analysis

• RESTful API for external integrations

Made with ❤️ by the Claude Code team