Chatsum

You can run the Chatsum MCP Server to query and summarize your chat messages. It stores chats in a database and exposes a simple runtime that your MCP client can query to generate concise summaries of conversations.

How to use

Once the server is running, you can query stored chat messages and request summaries for conversations that match your criteria. Use your MCP client to specify the parameters you want, such as date ranges or participant filters, and request a summarized result. The server returns concise summaries that help you quickly understand long chat threads without reading every message.

How to install

Prerequisites you need before installation: Node.js and a package manager. The project uses PNPM to manage dependencies.

# Install PNPM if you don't have it
npm install -g pnpm

# In your project directory, install dependencies
pnpm install

# Build the server for production or local use
pnpm build

# Optional: run in watch mode for auto-rebuild during development
pnpm watch

Configuration for local runtime and integration

Set the environment variable that points to your chat database before starting the server. Create a .env file in the root directory (or export the variable in your shell):

CHAT_DB_PATH=path-to/chatbot/data/chat.db

Start the server locally

Start the MCP server using the built entry point. You can run it directly with Node and the built index, ensuring the environment variable is set to your chat database path.

export CHAT_DB_PATH=path-to/chatbot/data/chat.db
node build/index.js

Debugging

For debugging MCP servers that communicate over stdio, you can use the MCP Inspector tool. It provides a browser-based interface to inspect runtime behavior and logs.

pnpm inspector

Configuration for Claude Desktop integration

If you use Claude Desktop, add the Chatsum MCP server configuration to the client config so Claude can communicate with it.

{
  "mcpServers": {
    "mcp-server-chatsum": {
      "command": "path-to/bin/node",
      "args": ["path-to/mcp-server-chatsum/build/index.js"],
      "env": {
        "CHAT_DB_PATH": "path-to/mcp-server-chatsum/chatbot/data/chat.db"
      }
    }
  }
}

Available tools

query_chat_messages

Query chat messages with given parameters and generate summarized results based on the query prompt.