Cursor-history-MCP

Cursor-history-MCP

2

Cursor History MCP is an API service for searching vectorized chat history from Cursor IDE. It uses FastAPI, LanceDB, and Ollama to provide efficient data access and includes features like Docker support and local language model integration. The project is self-hosted, allowing users full control over their data.

Overview

Welcome to the Cursor History MCP repository! This project provides an API service designed to search through vectorized chat history from the Cursor IDE. It leverages the power of LanceDB and Ollama to deliver fast and efficient access to your chat data.

Features

  • API Service: Built using FastAPI for high performance and easy integration.
  • Vectorized Search: Utilizes embeddings to enhance search capabilities.
  • Self-Hosted: You can run this service locally or on your own server.
  • Docker Support: Easy to deploy with Docker.
  • Integration with Ollama: Access local LLM models for advanced processing.

Getting Started

To get started with Cursor History MCP, follow these steps:

Prerequisites

Make sure you have the following installed:

  • Docker
  • Python 3.8 or higher
  • FastAPI
  • LanceDB
  • Ollama

Installation

  1. Clone the repository and navigate to the directory.
  2. Build the Docker image.
  3. Run the Docker container.
  4. Access the API at the provided local URL to explore the endpoints.

Downloading Releases

To get the latest version, visit the Releases section. Download the required file and execute it to set up your environment.

Usage

Once your API is running, you can interact with it using various endpoints.

  • Search Chat History: Use the /search endpoint with the POST method to search through chat history using a query string.

  • Get Chat History: Use the /history endpoint with the GET method to retrieve the entire chat history.

Topics

Important topics include API, Chat History, Docker, Embeddings, FastAPI, LanceDB, Local LLM, MCP Server, Ollama, RAG, Self-Hosted, and Vector Database.

Contributing

To contribute, fork the repository, create a new branch, make changes, and submit a pull request.

License

This project is licensed under the MIT License.

Support

For support, check the Releases section for updates or open an issue in the repository.