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

Metadata

Release files for arrowspace-mcp 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for arrowspace-mcp 0.4.0
File	Size	Uploaded
arrowspace_mcp-0.4.0.tar.gz	20.1 kB	Jun 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for arrowspace-mcp 0.4.0
File	Interpreter	ABI	Platform	Reset
arrowspace_mcp-0.4.0-py3-none-any.whl 20.6 kB Jun 26, 2026	Python 3	none	any	Details

Total release size: 40.7 kB

Release files / arrowspace_mcp-0.4.0.tar.gz

Download URL	arrowspace_mcp-0.4.0.tar.gz
Size	20.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`d948d8f184b0a1a47b87c6514d64bb14f8b148e87b67b40a17e93cbf85564403`
BLAKE2b-256 checksum How to use checksums	`08262d1837c2ff803594799a43c9974677432350b9536211ecc40fb492e07911`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is 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}`

Release files / arrowspace_mcp-0.4.0-py3-none-any.whl

Download URL	arrowspace_mcp-0.4.0-py3-none-any.whl
Size	20.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9354eafd243a35c3476abf5a10eb2432bd1bede2e3f295b587272011e157c8e9`
BLAKE2b-256 checksum How to use checksums	`054a530e5ef38202d2af83931872c3eed45eb57fcc8c679365cf0c94436db7a8`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is 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}`

Release history Release notifications | RSS feed

This release

0.4.0 This release

Jun 26, 2026 2 release files

0.3.0