{"id":47097886,"url":"https://github.com/futuretea/localrecall-mcp-server","last_synced_at":"2026-03-12T14:55:06.064Z","repository":{"id":337772936,"uuid":"1155110731","full_name":"futuretea/localrecall-mcp-server","owner":"futuretea","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-11T08:48:16.000Z","size":46,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-11T14:52:32.774Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/futuretea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-11T06:09:23.000Z","updated_at":"2026-02-11T08:44:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/futuretea/localrecall-mcp-server","commit_stats":null,"previous_names":["futuretea/localrecall-mcp-server"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/futuretea/localrecall-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretea%2Flocalrecall-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretea%2Flocalrecall-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretea%2Flocalrecall-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretea%2Flocalrecall-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/futuretea","download_url":"https://codeload.github.com/futuretea/localrecall-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretea%2Flocalrecall-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30429080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T14:34:45.044Z","status":"ssl_error","status_checked_at":"2026-03-12T14:09:33.793Z","response_time":114,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-12T14:55:05.074Z","updated_at":"2026-03-12T14:55:06.042Z","avatar_url":"https://github.com/futuretea.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LocalRecall MCP Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for LocalRecall knowledge base management.\n\n## Features\n\n- **Multiple Modes**: Supports stdio, HTTP, and SSE transport modes\n- **Knowledge Management**: Full CRUD operations for LocalRecall collections and documents\n- **Search Capabilities**: Semantic search across your knowledge base\n- **Flexible Configuration**: Command-line flags, environment variables, or configuration files\n- **Collection Isolation**: Lock the server to a single collection for security\n- **Multiple Output Formats**: JSON, YAML output formats\n- **Cross-platform**: Native binaries for Linux, macOS, and Windows\n\n## Comparison with MCPs/localrecall\n\n| Feature | localrecall-mcp-server | MCPs/localrecall |\n|---------|------------------------|------------------|\n| Transport Modes | stdio, HTTP, SSE | stdio only |\n| Configuration | Multiple sources (flags, env, file) | Environment variables only |\n| Collection Isolation | Enforced (hides cross-collection tools) | Default only (can be overridden) |\n| Output Formats | JSON, YAML | JSON only |\n| Tool Control | Enable/disable specific tools | All tools enabled |\n| Architecture | Modular, extensible | Simple, monolithic |\n\n## Installation\n\n### From Source\n\n```bash\ngit clone https://github.com/futuretea/localrecall-mcp-server.git\ncd localrecall-mcp-server\nmake build\n```\n\n### Using Docker\n\n```bash\ndocker build -t localrecall-mcp-server .\n```\n\n## Quick Start\n\n### Stdio Mode (for MCP clients)\n\n```bash\n./localrecall-mcp-server \\\n  --localrecall-url http://localhost:8080 \\\n  --localrecall-collection my-collection\n```\n\n### HTTP/SSE Mode (network access)\n\n```bash\n./localrecall-mcp-server \\\n  --port 8080 \\\n  --localrecall-url http://localhost:8080 \\\n  --localrecall-api-key your-api-key\n```\n\n## Configuration\n\nConfiguration can be set via CLI flags, environment variables, or a config file.\n\n### Priority (highest to lowest)\n1. Command-line flags\n2. Environment variables (prefix: `LOCALRECALL_MCP_`)\n3. Configuration file\n4. Default values\n\n### CLI Options\n\n```bash\n./localrecall-mcp-server --help\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--config` | Config file path (YAML) | |\n| `--port` | Port for HTTP/SSE mode (0 = stdio mode) | `0` |\n| `--sse-base-url` | Public base URL for SSE endpoint | |\n| `--log-level` | Log level (0-9) | `5` |\n| `--localrecall-url` | LocalRecall API URL | `http://localhost:8080` |\n| `--localrecall-api-key` | LocalRecall API key | |\n| `--localrecall-collection` | Collection isolation (locks to this collection) | |\n| `--list-output` | Output format (json, yaml) | `json` |\n| `--output-filters` | Fields to filter from output | |\n| `--enabled-tools` | Tools to enable | |\n| `--disabled-tools` | Tools to disable | |\n\n### Configuration File\n\nCreate `config.yaml`:\n\n```yaml\nport: 0  # 0 for stdio, or set a port like 8080 for HTTP/SSE\n\nlog_level: 5\n\nlocalrecall_url: http://localhost:8080\nlocalrecall_api_key: your-api-key\nlocalrecall_collection: my-collection  # locks server to this collection\n\nlist_output: json\n\nenabled_tools: []\ndisabled_tools: []\n```\n\n### Environment Variables\n\nUse `LOCALRECALL_MCP_` prefix with underscores:\n\n```bash\nLOCALRECALL_MCP_PORT=8080\nLOCALRECALL_MCP_LOCALRECALL_URL=http://localhost:8080\nLOCALRECALL_MCP_LOCALRECALL_API_KEY=your-api-key\n```\n\n## MCP Client Integration\n\n### Claude Code\n\n```bash\nclaude mcp add localrecall -- /path/to/localrecall-mcp-server \\\n  --localrecall-url http://localhost:8080 \\\n  --localrecall-collection my-collection\n```\n\n### VS Code / Cursor\n\nAdd to `.vscode/mcp.json` or `~/.cursor/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"localrecall\": {\n      \"command\": \"/path/to/localrecall-mcp-server\",\n      \"args\": [\n        \"--localrecall-url\",\n        \"http://localhost:8080\",\n        \"--localrecall-collection\",\n        \"my-collection\"\n      ]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### search\nSearch content in a LocalRecall collection.\n\n**Parameters:**\n- `query` (string, required): The search query\n- `max_results` (number, optional): Maximum number of results (default: 5)\n- `collection_name` (string, required*): The collection to search\n\n### add_document\nAdd a document to a LocalRecall collection.\n\n**Parameters:**\n- `filename` (string, required): The filename for the document\n- `file_path` (string, optional): Path to file to upload\n- `file_content` (string, optional): File content as string\n- `collection_name` (string, required*): The collection to add to\n\n### create_collection\nCreate a new collection in LocalRecall. **Hidden when collection isolation is active.**\n\n**Parameters:**\n- `name` (string, required): The name of the collection to create\n\n### reset_collection\nReset (clear) a collection in LocalRecall. **Hidden when collection isolation is active.**\n\n**Parameters:**\n- `name` (string, required): The name of the collection to reset\n\n### list_collections\nList all collections in LocalRecall. **Hidden when collection isolation is active.**\n\n**Parameters:** None\n\n### list_files\nList files in a LocalRecall collection.\n\n**Parameters:**\n- `collection_name` (string, required*): The collection to list\n\n### delete_entry\nDelete an entry from a LocalRecall collection.\n\n**Parameters:**\n- `entry` (string, required): The filename of the entry to delete\n- `collection_name` (string, required*): The collection to delete from\n\n\u003e **\\*** When `--localrecall-collection` is set, `collection_name` is removed from all tool schemas and automatically enforced. The parameter is only required in multi-collection mode.\n\n## HTTP/SSE Mode\n\nWhen running with a port number, the server exposes these endpoints:\n\n- `/healthz` - Health check\n- `/mcp` - Streamable HTTP endpoint\n- `/sse` - Server-Sent Events endpoint\n- `/message` - Message endpoint for SSE clients\n\nExample:\n\n```bash\n./localrecall-mcp-server --port 8080 \\\n  --localrecall-url http://localhost:8080 \\\n  --localrecall-api-key your-api-key\n```\n\nAccess at: `http://localhost:8080`\n\n## Development\n\n### Build\n\n```bash\nmake build\n```\n\n### Run Tests\n\n```bash\nmake test\n```\n\n### Format Code\n\n```bash\nmake format\n```\n\n### Test with MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector@latest $(pwd)/localrecall-mcp-server \\\n  --localrecall-url http://localhost:8080\n```\n\n## Architecture\n\n```\nlocalrecall-mcp-server/\n├── cmd/                        # Application entry points\n├── internal/cmd/               # Command-line interface\n├── pkg/\n│   ├── client/                 # LocalRecall API client\n│   ├── core/                   # Core utilities (config, logging, version)\n│   ├── server/                 # MCP and HTTP servers\n│   └── toolset/                # Tool implementations\n```\n\n## License\n\nApache-2.0\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\n- GitHub Issues: https://github.com/futuretea/localrecall-mcp-server/issues\n- LocalRecall Documentation: https://github.com/mudler/LocalRecall\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturetea%2Flocalrecall-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuturetea%2Flocalrecall-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturetea%2Flocalrecall-mcp-server/lists"}