Sulci MCP server for AI coding assistants (Claude, OpenCode, and other MCP clients)
Project description
sulci-mcp
MCP server for Sulci — the universal AI context layer. Gives any MCP-compatible AI tool access to your cross-tool knowledge store.
Installation
pip install sulci-mcp
Or run directly:
uvx sulci-mcp
Quick Start
stdio (default — Claude Desktop, Claude Code)
sulci-mcp
Streamable HTTP (Cursor, VS Code Copilot, Windsurf, etc.)
sulci-mcp --transport streamable-http
This starts an HTTP server on http://127.0.0.1:8000/mcp.
With authentication
export SULCI_API_KEY=your-secret-key
sulci-mcp --transport streamable-http
Clients must send Authorization: Bearer your-secret-key header. When SULCI_API_KEY is unset, no auth is required (dev mode).
Environment Variables
| Variable | Default | Description |
|---|---|---|
SULCI_MCP_TRANSPORT |
stdio |
Transport: stdio or streamable-http |
SULCI_MCP_HOST |
127.0.0.1 |
HTTP bind address |
SULCI_MCP_PORT |
8000 |
HTTP port |
SULCI_API_KEY |
(empty) | Bearer token for HTTP auth (empty = no auth) |
SULCI_DATA_DIR |
~/.sulci |
Knowledge store directory |
SULCI_LLM_PROVIDER |
openai |
LLM for extraction: openai or anthropic |
OPENAI_API_KEY |
Required if using OpenAI provider | |
ANTHROPIC_API_KEY |
Required if using Anthropic provider |
CLI flags (--transport, --host, --port) override environment variables.
Tools Provided
- query_context — Semantic search across your knowledge
- add_knowledge — Store facts, decisions, preferences
- record_interaction — Extract knowledge from conversations
- list_knowledge — Browse stored knowledge
- delete_knowledge — Remove a knowledge atom
- list_conflicts — View contradictions between atoms
- resolve_conflict — Pick a winner in a conflict
- verification_queue — Review atoms that need re-verification
Connection Guide
See docs/CONNECTION_GUIDE.md for copy-pasteable config for Claude Desktop, Claude Code, Cursor, VS Code Copilot, Windsurf, and Continue.dev.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sulci_mcp-0.2.1.tar.gz.
File metadata
- Download URL: sulci_mcp-0.2.1.tar.gz
- Upload date:
- Size: 12.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
841c96cfe2dc284998314b8d02169764c555c5e4201da1834da53eae259a84a2
|
|
| MD5 |
368248d3331fbd4acf51c43a18e58a25
|
|
| BLAKE2b-256 |
dfd307b3d741167b4116f987b089253e48b112050c4cef37c495cbda4610a199
|
File details
Details for the file sulci_mcp-0.2.1-py3-none-any.whl.
File metadata
- Download URL: sulci_mcp-0.2.1-py3-none-any.whl
- Upload date:
- Size: 14.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
60967d05ce80003194b8bbb6ca9759b0029ac8cc53df97445555cb76abc07964
|
|
| MD5 |
57302afa9b67291bb5b07c8ebb8bf08d
|
|
| BLAKE2b-256 |
7bbf633190eea020f75da9f2a494bbf48a0833c9e1ca36b0ceaa502057e76679
|
