ArrowSpace MCP
MCP (Model Context Protocol) server for ArrowSpace spectral vector search.
Exposes ArrowSpace's graph-Laplacian-based spectral search as MCP tools for AI agents.
Quick start
# Run with spectral analysis support (scipy, scikit-learn)
uv sync --extra spectral
uv run arrowspace-mcp
# Run with skill-based parameter suggestions
uv sync --extra skilled
uv run arrowspace-mcp
# Run with everything
uv sync --extra all
uv run arrowspace-mcp
Client configuration
Claude Desktop
{
"mcpServers": {
"arrowspace": {
"command": "uvx",
"args": ["arrowspace-mcp"]
}
}
}
Cursor
Add to Cursor MCP configuration:
{
"mcpServers": {
"arrowspace": {
"command": "uvx",
"args": ["arrowspace-mcp"]
}
}
}
OpenCode
{
"mcpServers": {
"arrowspace": {
"command": "uvx",
"args": ["arrowspace-mcp"]
}
}
}
Transports
| Transport | Command |
|---|---|
| stdio (default) | uv run arrowspace-mcp |
| SSE | uv run arrowspace-mcp --transport sse --port 8765 |
CLI flags
| Flag | Default | Description |
|---|---|---|
--transport |
stdio |
Transport protocol (stdio or sse) |
--host |
127.0.0.1 |
Host to bind (SSE only) |
--port |
8765 |
Port to bind (SSE only) |
--allowed-paths |
. |
Colon-separated allowed directories for Zarr input paths |
--ttl |
3600 |
Idle TTL in seconds; index expires when unused for this duration |
--max-indexes |
100 |
Maximum concurrent indexes |
Tools
| Tool | Description |
|---|---|
build_index |
Build a spectral index from vectors (inline or Zarr path) |
search |
Query with λτ spectral gating |
lambdas |
Per-item λτ scores with optional summary stats |
lambdas_sorted |
Sorted λτ scores (least to most coherent) |
spectral_analysis |
Laplacian eigenvalue spectrum, components, or clusters |
suggest_params |
Heuristic graph parameters based on dataset size and dimensionality |
delete_index |
Remove an index from memory |
SSE deployment
uv run arrowspace-mcp --transport sse --host 0.0.0.0 --port 8765
Connect via http://<host>:8765/sse with messages at http://<host>:8765/messages/.
Development
git clone https://github.com/Genefold/arrowspace-mcp
cd arrowspace-mcp
uv sync
uv run arrowspace-mcp
With optional deps for spectral analysis
uv sync --extra spectral --extra skilled
License
Apache 2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
arrowspace_mcp-0.4.0.tar.gz
(20.1 kB
view details)
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 arrowspace_mcp-0.4.0.tar.gz.
File metadata
- Download URL: arrowspace_mcp-0.4.0.tar.gz
- Upload date:
- Size: 20.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","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 |
d948d8f184b0a1a47b87c6514d64bb14f8b148e87b67b40a17e93cbf85564403
|
|
| MD5 |
0d1fd9b70d94fe020e26af5ee1b64ab8
|
|
| BLAKE2b-256 |
08262d1837c2ff803594799a43c9974677432350b9536211ecc40fb492e07911
|
File details
Details for the file arrowspace_mcp-0.4.0-py3-none-any.whl.
File metadata
- Download URL: arrowspace_mcp-0.4.0-py3-none-any.whl
- Upload date:
- Size: 20.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","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 |
9354eafd243a35c3476abf5a10eb2432bd1bede2e3f295b587272011e157c8e9
|
|
| MD5 |
334c9343eb6a209ca2386e33ce76ce6c
|
|
| BLAKE2b-256 |
054a530e5ef38202d2af83931872c3eed45eb57fcc8c679365cf0c94436db7a8
|
