first commit

README.md

@@ -0,0 +1,113 @@
+# St-Pierre - Knowledge MCP Server
+
+Remote MCP server that stores and retrieves knowledge using Qdrant vector
+database and OpenAI embeddings.
+
+## Tools
+
+### `store_knowledge`
+Store text with optional metadata. Automatically generates embeddings via
+OpenAI and persists them in Qdrant.
+
+Parameters:
+- `content` (string, required): Text content to store
+- `metadata` (object, optional): Arbitrary key-value pairs
+
+### `search_knowledge`
+Semantic search across stored knowledge.
+
+Parameters:
+- `query` (string, required): Search query
+- `limit` (number, optional, default 5): Max results
+
+## Setup
+
+### Prerequisites
+
+- Qdrant instance
+- OpenAI API key
+
+### Environment Variables
+
+```env
+QDRANT_URL=localhost            # Required: Qdrant hostname
+QDRANT_PORT=6334                # Optional: Qdrant gRPC port (default: 6334)
+QDRANT_API_KEY=                 # Optional: Qdrant API key
+QDRANT_TLS=false                # Optional: Enable TLS
+OPENAI_API_KEY=sk-...           # Required: API key (OpenAI or DeepSeek)
+EMBEDDING_BASE_URL=https://api.openai.com/v1  # Optional: base URL (OpenAI by default)
+EMBEDDING_MODEL=text-embedding-3-small  # Optional: embedding model
+MCP_TOKEN=my-secret-token       # Required: Bearer token for auth
+PORT=8080                       # Optional: HTTP port (default: 8080)
+```
+
+### Running
+
+```bash
+# Using OpenAI embeddings
+export QDRANT_URL=localhost
+export OPENAI_API_KEY=sk-...
+export MCP_TOKEN=my-secret-token
+./st-pierre
+
+# Using DeepSeek embeddings
+export OPENAI_API_KEY=sk-...
+export EMBEDDING_BASE_URL=https://api.deepseek.com/v1
+export EMBEDDING_MODEL=deepseek-chat
+export MCP_TOKEN=my-secret-token
+./st-pierre
+```
+
+### Nix
+
+```bash
+# Build and run directly
+nix run github:didier/st-pierre -- --help
+
+# Development shell
+nix develop
+```
+
+### NixOS Module
+
+```nix
+# flake.nix
+{
+  inputs.st-pierre.url = "github:didier/st-pierre";
+  ...
+}
+
+# configuration.nix
+{ inputs, ... }: {
+  imports = [ inputs.st-pierre.nixosModules.st-pierre ];
+
+  services.st-pierre = {
+    enable = true;
+    port = 8080;
+    qdrantUrl = "localhost";
+    openaiApiKeyFile = /run/secrets/openai-api-key;
+    tokenFile = /run/secrets/mcp-token;
+  };
+}
+```
+
+The NixOS module creates a dedicated `st-pierre` system user and a systemd
+service. Secrets (API keys, tokens) should be provided as files rather than
+inline strings.
+
+## MCP Client Configuration
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "knowledge": {
+      "url": "http://your-server:8080/mcp",
+      "headers": {
+        "Authorization": "Bearer my-secret-token"
+      }
+    }
+  }
+}
+```