ChatSum

Queries and summarizes chat messages by accessing a local chat database and returning concise results through an MCP interface.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-chatmcp_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"
      }
    }
  }
}

You can deploy this MCP Server to summarize your chat messages by storing conversations locally and exposing a simple MCP endpoint to query and generate concise summaries from your chat data.

How to use

You use the chatsum MCP server by querying your stored chat messages and requesting summaries through an MCP client. Start the server, ensure your chat database is accessible, then issue a query to retrieve relevant messages and receive a summarized result that you can display or analyze further.

How to install

Prerequisites: you need Node.js and a package manager available on your system. The setup uses PNPM for installing dependencies, building the project, and running in development mode.

# Install dependencies
pnpm install

# Build the server
pnpm build

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

Configuration and usage notes

To run the server locally, you must provide the path to your chat database. The server is started via a local runtime (stdio) configuration that invokes Node to run the built index. You supply the database path through an environment variable named CHAT_DB_PATH.

Example environment variable setup (adjust paths to your environment):

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

Troubleshooting and debugging

Since MCP servers communicate over stdio, debugging can be challenging. Use the MCP Inspector to access debugging tools in your browser. This tool provides a URL to inspect the MCP server while it runs.

pnpm inspector

Notes on installation for Claude Desktop

If you use Claude Desktop, you can configure the server by adding an MCP server entry that points to the Node runtime and the built index. The environment variable CHAT_DB_PATH must point to your local chat database.

Example configuration snippet for Claude Desktop (JSON):

{
  "mcpServers": {
    "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 summaries based on the query prompt