Infino MCP server

An MCP server for Infino — it lets an AI agent run keyword, semantic, hybrid, and SQL retrieval over your data on object storage, from any MCP-compatible client (Claude Code, Claude Desktop, Cursor, VS Code, and others). Published on npm as @infino-ai/mcp-server and listed on the official MCP Registry as io.github.infino-ai/mcp-server (which propagates to catalogs like Smithery, Glama, and PulseMCP).

• No API key. Semantic search embeds queries with a local model — nothing leaves the machine for embedding.
• Read-only by default. Writes and full SQL are opt-in behind a single environment flag.
• Bring your own storage. Point it at a local path or your own bucket (S3, Azure, or any S3-compatible store).

Contents

• Requirements
• Quick start
• Claude Code plugin (one-step install)
• Client setup
  • Claude Code
  • Claude Desktop
  • Cursor
  • VS Code
  • Other MCP clients
• Configuration
  • Environment variables
  • Storage backends
• Tools
• Security & data handling
• How retrieval works
• Troubleshooting
• Local development
• License

Requirements

• Node.js ≥ 18 (the server runs as a Node process over stdio).
• An MCP-compatible client (Claude Code, Claude Desktop, Cursor, VS Code, …).
• Data reachable by Infino — a local directory, or a bucket with credentials available in the environment (see Storage backends).
• On first run the server downloads the local embedding model (~90 MB) once and caches it; subsequent runs are offline for embedding.

Quick start

The server is launched by your MCP client over stdio — you don't run it directly in normal use. Every client config follows the same shape: command npx -y @infino-ai/mcp-server, with configuration supplied via environment variables. Set INFINO_MCP_URI to the data you want to serve — a local path or a bucket URI. If it's omitted, the server uses a durable per-user directory (~/.infino/mcp) so data persists across restarts; point INFINO_MCP_URI at your own path or bucket to serve existing data.

{
  "command": "npx",
  "args": ["-y", "@infino-ai/mcp-server"],
  "env": {
    "INFINO_MCP_URI": "/Users/me/.infino/memory"
  }
}

The sections below show the exact place each client expects this block.

Claude Code plugin (one-step install)

For Claude Code, this repo is also a plugin marketplace. Installing the plugin wires up the MCP server plus a how-to-use skill and an /infino-search command in one step — no JSON to edit. Inside Claude Code:

/plugin marketplace add infino-ai/infino-mcp
/plugin install infino@infino-ai

On enable you'll be prompted for your Infino data URI (INFINO_MCP_URI) and whether to enable writes. That's it — the infino_* tools, the using-infino skill, and /infino-search <query> are then available. (Other clients: use the Client setup configs below.)

Client setup

Claude Code

Add the server with the CLI. Use `--sco

... View full README on GitHub