mcpField
⚡
⚡PhotonDB

⚡PhotonDB

Local
github.com/s1ddh3shDatabases0Updated 70w ago
Repository

About ⚡PhotonDB

PhotonDB is a C++17 in-memory key-value database with mutable data structures and a TCP-based client-server protocol. It also includes an MCP server for natural-language interaction with the data, which is under active development.

Key features

  1. 01In-memory key-value data storage
  2. 02Mutable data structures
  3. 03TCP-based client-server protocol
  4. 04C++17 implementation
  5. 05Command-line interface with photon-cli

Use cases

  1. 01Store and retrieve key-value data
  2. 02Interact with PhotonDB through photon-cli
  3. 03Use an MCP client for natural-language data interaction

MCP support

The project includes an MCP server implemented in server.py, enabling MCP clients to interact with PhotonDB data using natural language. MCP development is ongoing.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

⚡PhotonDB

PhotonDB is a high-performance in-memory key-value database server written in C++17. It provides access to mutable data structures via a simple TCP-based protocol using a server-client model.

PhotonDB also integrates with MCP — the Model Context Protocol — enabling natural-language interactions with the data, making it more than just a database (actively under development).

Using PhotonDB with photon-cli

photon-cli is PhotonDB's command line interface

You can start a photon server instance ./src/server and then, in another terminal try the following:

% cd src/
% ./photon-cli
⚡photon> ZAP
 (str) ZING
⚡photon> set foo bar
 OK
⚡photon> get foo
 (str) bar

Using PhotonDB with MCP client

PhotonDB also supports the Model Context Protocol (MCP) for natural-language interactions. The MCP server is implemented in server.py

Adding MCP to your project

We recommend using uv as a python package manager

uv add "mcp[cli]"

To run the mcp command with uv :

uv run mcp

You can install this server.py on Claude Desktop and interact with it right away by running :

uv run mcp install server.py

Building PhotonDB

PhotonDB uses CMake for building. Make sure you have CMake (version 3.10 or newer) and a C++17 compiler installed.

#Clone the repository and enter the directory
git clone https://github.com/s1ddh3sh/PhotonDB.git
cd PhotonDB

#Create a build directory and run CMake
mkdir build
cd build
cmake ..

#Build the server and CLI
make

Make sure to run the make command in the build dir to compile the changes and build the server/client

API Reference

Please refer the API.md for full list of supported commands and usage examples

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.