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.
Metadata
Release files for sulci-mcp 0.2.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sulci_mcp-0.2.11.tar.gz | 19.7 kB | Without provenance | Details for sulci_mcp-0.2.11.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sulci_mcp-0.2.11-py3-none-any.whl | Python 3 | none | any | Details for sulci_mcp-0.2.11-py3-none-any.whl |
Total release size: 40.5 kB
Release files / sulci_mcp-0.2.11.tar.gz
| Download URL | sulci_mcp-0.2.11.tar.gz |
|---|---|
| Size | 19.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
991be7b6bd4f8ebf4389ffb75b33299041443108778a12eabc9e9cc6e4a141ce
|
|
BLAKE2b-256 checksum How to use checksums |
e11877b685a199a36853f5f7d637c26dbdfc9cd1a15839b5a6b09dbbb569c50f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / sulci_mcp-0.2.11-py3-none-any.whl
| Download URL | sulci_mcp-0.2.11-py3-none-any.whl |
|---|---|
| Size | 20.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac2e105849464037bb2ae861175d1f720338052240555236629e4c6f2b3de8bf
|
|
BLAKE2b-256 checksum How to use checksums |
86f8d3640ab4a50fed1d931476c2373c7883ab7b88d809a9c9f5809e1c50d197
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for sulci-mcp 0.2.11
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.