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, notcrow-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
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
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 crow_mcp-0.1.34.tar.gz.
File metadata
- Download URL: crow_mcp-0.1.34.tar.gz
- Upload date:
- Size: 96.2 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4290c27f07e27166f5b1d38b48a36229a2b93b0c889f0d649e3618b8e6768852
|
|
| MD5 |
4e4da78681bb436a3d97bd5138716453
|
|
| BLAKE2b-256 |
2404e684234c3070ba13283782a0f68b27b5c32c53b4de02bd95809e7f0df72a
|
File details
Details for the file crow_mcp-0.1.34-py3-none-any.whl.
File metadata
- Download URL: crow_mcp-0.1.34-py3-none-any.whl
- Upload date:
- Size: 38.7 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69b4037c6fb7a85fa9fef3e4bd69bf0a4d8d0094b120ce91e97b5ab3e1dff0bc
|
|
| MD5 |
9240db979204ea92bd8a2255aad88824
|
|
| BLAKE2b-256 |
88824b118deb5a0a4f276a241d0fc2c5a0aac297e0e0ffc39ffd8d5b04ec7bfd
|
