Knowledgebaseserver

🚀 MCP Knowledge Base Server

A knowledge base server based on the Model Context Protocol (MCP), which allows large language models to store memories during conversations and search for them later. Memories are stored in an SQLite database, and its full-text search feature is used to implement memory search.

🚀 Quick Start

Usage

Two environment variables control the location and file name of the database:

DATABASE_NAME: Specify a custom database file name using the default location. For example, my_custom_db.sqlite.

DATABASE_PATH: Specify the full database file path (ignores DATABASE_NAME). For example, /Users/your_name/.db/my_db.sqlite.

Docker

When using Docker, you must create a persistent volume to store the database (advanced users can choose to mount a directory in the file system if needed). Run docker volume create knowledgebase to set it up, and then add the following content to your claude_desktop_config.json configuration file:

If you want to use a custom database file with Docker, you must pass DATABASE_PATH through the --env parameter. For example (place these strings in the args array of the configuration file, before the image name): "--env", "DATABASE_PATH=/db/my_db.sqlite".

{
  "mcpServers": {
    "knowledgebase": {
      "command": "docker",
      "args": [
        "run",
        "--interactive",
        "--rm",
        "--volume", "knowledgebase:/db",
        "mbcrawfo/knowledge-base-server"
      ]
    }
  }
}

Local Run (Using dotnet CLI)

1. You need to install the .Net 9 SDK first.
2. Clone this repository.
3. Navigate to the repository directory in the terminal and run dotnet build.
4. Add the following configuration to the claude_desktop_config.json file (if you encounter errors, try specifying the full path of the dotnet CLI).

When running locally, the default database location is in your application data directory.

{
  "mcpServers": {
    "knowledgebase": {
      "command": "dotnet",
      "args": [
        "run",
        "--project", "/full/path/to/repo/src/KnowledgeBaseServer/KnowledgeBaseServer.csproj",
        "--no-restore",
        "--no-build"
      ]
    }
  }
}

💡 Prompt

The server includes a "General Memory Usage" prompt to inform large language models how to use memories. However, you can create custom prompts according to your specific needs.

🔧 Development

You can use the --init-db parameter with this application to create or upgrade a test database. Run dotnet run -- --init-db /path/to/db.sqlite from the KnowledgeBaseServer project directory.