MCP.so
Sign In

Cursor History MCP Server

@Nossim

Basic information

Category

Developer Tools

Transports

stdio

Author

Nossim

About Cursor History MCP Server

API service to search vectorized Cursor IDE chat history using LanceDB and Ollama

Cursor History MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Cursor-history-MCP": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "cursor-history-mcp",
        "."
      ]
    }
  }
}

Cursor History MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Cursor History MCP πŸ“œ?

Cursor History MCP is an API service that enables vectorized search through chat history from the Cursor IDE. It uses LanceDB for vector storage and Ollama for local LLM processing, and is designed for self-hosted deployment.

How to use Cursor History MCP πŸ“œ?

Clone the repository, build the Docker image (docker build -t cursor-history-mcp .), and run the container (docker run -p 8000:8000 cursor-history-mcp). Access the API documentation at http://localhost:8000/docs. Use the POST /search endpoint to query chat history and GET /history to retrieve all records.

Key features of Cursor History MCP πŸ“œ

  • FastAPI-based API for high performance
  • Vectorized search using embeddings
  • Self-hosted deployment for data control
  • Docker support for easy setup
  • Integration with Ollama for local LLMs
  • LanceDB vector database for efficient storage

Use cases of Cursor History MCP πŸ“œ

  • Search past chat conversations in Cursor IDE
  • Index and retrieve chat history with semantic queries
  • Self-host a private chat history search service
  • Combine with local LLMs for retrieval-augmented generation

Frequently asked questions

1

What are the prerequisites to run Cursor History MCP πŸ“œ?

You need Docker, Python 3.8 or higher, FastAPI, LanceDB, and Ollama installed.

2

How do I install and run Cursor History MCP πŸ“œ?

Clone the repository, build the Docker image, and run the container. See the Getting Started section for exact commands.

3

How can I search my chat history?

Send a POST request to the `/search` endpoint with a JSON body containing your query string.

4

How do I retrieve the entire chat history?

Send a GET request to the `/history` endpoint to get the full list of chat messages.

5

Is my data stored locally?

The service is self-hosted, meaning you can run it locally or on your own server, keeping your data under your control.

Comments

More Developer Tools MCP servers