https://github.com/mbcrawfo/KnowledgeBaseServer
Model Context Protocol (MCP) server allowing LLMs to store and search knowledge in a SQLite database
https://github.com/mbcrawfo/KnowledgeBaseServer
Last synced: 6 months ago
JSON representation
Model Context Protocol (MCP) server allowing LLMs to store and search knowledge in a SQLite database
- Host: GitHub
- URL: https://github.com/mbcrawfo/KnowledgeBaseServer
- Owner: mbcrawfo
- License: mit
- Created: 2025-04-06T04:37:42.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-05-23T16:02:10.000Z (6 months ago)
- Last Synced: 2025-05-23T17:07:46.788Z (6 months ago)
- Language: C#
- Size: 272 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **KnowledgeBaseServer** - Model Context Protocol (MCP) server allowing LLMs to store and search knowledge in a SQLite database `c#` `mcp` `server` `database` `llm` `git clone https://github.com/mbcrawfo/KnowledgeBaseServer` (🔌 API)
- awesome-dotnet-mcp - KnowledgeBaseServer - Model Context Protocol (MCP) server allowing LLMs to store and search knowledge in a SQLite database (Servers / DotNET)
README
# MCP KnowledgeBase Server
[](https://hub.docker.com/r/mbcrawfo/knowledge-base-server)
A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that allows LLMS to store memories during a conversation and search them later. Memories are stored in a [SQLite](https://www.sqlite.org) database, and its full text search features power the memory search.
## Usage
Two environment variables control the location and filename of the database.
`DATABASE_NAME`: Use the default location, but a custom db filename. For example, `my_custom_db.sqlite`.
`DATABASE_PATH`: Specify the fully path to the db file (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 mount a folder from their file system, if desired). Run `docker volume create knowledgebase` to set it up, then configure the server in your `claude_desktop_config.json` as below.
If you want to use a custom database file with docker you must use `DATABASE_PATH` and pass it to the docker command using the `--env` arg. For example (place these strings in the `args` array of the config, before the image name), `"--env", "DATABASE_PATH=/db/my_db.sqlite"`.
```json
{
"mcpServers": {
"knowledgebase": {
"command": "docker",
"args": [
"run",
"--interactive",
"--rm",
"--volume", "knowledgebase:/db",
"mbcrawfo/knowledge-base-server"
]
}
}
}
```
### Run locally with dotnet cli
1. You will need the [.Net 9 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/9.0).
2. Clone this repository.
3. Navigate to the repo in your terminal and run `dotnet build`.
4. Add the config below to `claude_desktop_config.json` (if you get errors, try specifying the full path to the dotnet cli).
When running locally the default database location is in your Application Data directory.
```json
{
"mcpServers": {
"knowledgebase": {
"command": "dotnet",
"args": [
"run",
"--project", "/full/path/to/repo/src/KnowledgeBaseServer/KnowledgeBaseServer.csproj",
"--no-restore",
"--no-build"
]
}
}
}
```
## Prompts
The server includes a "General Memory Usage" prompt to tell the LLM how to use memory. However you may wish to use a custom prompt to be more specific to your usage.
## Development
You can use the app with the `--init-db` parameter to create or upgrade databases for testing. From the KnowledgeBaseServer project directory, run `dotnet run -- --init-db /path/to/db.sqlite`.