crow-mcp

The built-in MCP tool server for crow-cli. Provides filesystem, terminal, web, vision, and memory tools over stdio.

Tools

Tool	Module	What it does
`read`	read	Read files with line numbers
`write`	write	Create or overwrite files
`edit`	editor	Precise string replacement with fuzzy matching
`terminal`	terminal	Shell commands in a persistent PTY session
`web_search`	web_search	Search the web via SearXNG (parallel queries)
`web_fetch`	web_fetch	Fetch a URL and extract content as markdown
`capture_webcam`	vision	Capture a frame from a webcam
`read_image_file`	vision	Read an image file for vision analysis
`list_sessions`	memory	List agent sessions by recent activity
`query_memory`	memory	Semantic search across all sessions
`query_session`	memory	Read or search within one session

⚠️ Tool names are not namespaced — read, not crow-mcp_read. Watch for collisions when registering additional MCP servers.

Usage

crow-mcp is started automatically by crow-cli as a child process. You don't normally run it directly.

To use it standalone:

# stdio
uv --project /path/to/crow-mcp run crow-mcp
# http in the background/separate service
uv --project /path/to/crow-mcp run crow-mcp --transport http --port 2770

Or register it in any MCP client config:

// stdio
{
  "mcpServers": {
    "crow-mcp": {
      "transport": "stdio",
      "command": "uv",
      "args": ["--project", "/path/to/crow-mcp", "run", "crow-mcp"]
    }
  }
}
// http
{
  "mcpServers": {
    "crow-mcp": {
      "transport": "http",
      "url": "http://127.0.0.1:2770/mcp"
    }
  }
}

Memory tools

The memory tools (list_sessions, query_memory, query_session) read the shared database through the crow-memory package with a read-only engine — BM25 keyword search via FTS5, no service involved. The db resolves from CROW_DB_URI (URI) → CROW_MEMORY_DB (path) → db_uri:/memory_path: in ~/.agents/crow/config.yaml → the default ~/.agents/crow/crow.db.

Development

uv sync --project crow-mcp
uv run --project crow-mcp pytest crow-mcp/tests

License

MIT

Metadata

Release files for crow-mcp 0.1.34

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

Source distribution (sdist)

Source distribution for crow-mcp 0.1.34
File	Size	Uploaded
crow_mcp-0.1.34.tar.gz	96.2 kB	Aug 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for crow-mcp 0.1.34
File	Interpreter	ABI	Platform	Reset
crow_mcp-0.1.34-py3-none-any.whl 38.7 kB Aug 13, 2026	Python 3	none	any	Details

Total release size: 134.9 kB

Release files / crow_mcp-0.1.34.tar.gz

Download URL	crow_mcp-0.1.34.tar.gz
Size	96.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`4290c27f07e27166f5b1d38b48a36229a2b93b0c889f0d649e3618b8e6768852`
BLAKE2b-256 checksum How to use checksums	`2404e684234c3070ba13283782a0f68b27b5c32c53b4de02bd95809e7f0df72a`
Upload date	Aug 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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 / crow_mcp-0.1.34-py3-none-any.whl

Download URL	crow_mcp-0.1.34-py3-none-any.whl
Size	38.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`69b4037c6fb7a85fa9fef3e4bd69bf0a4d8d0094b120ce91e97b5ab3e1dff0bc`
BLAKE2b-256 checksum How to use checksums	`88824b118deb5a0a4f276a241d0fc2c5a0aac297e0e0ffc39ffd8d5b04ec7bfd`
Upload date	Aug 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}`