Infino

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, GCS, 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. At minimum, set INFINO_MCP_URI to the data you want to serve.

{
  "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 --scope user to make it available in every project, or --scope project to commit it to the repo (writes a shared .mcp.json); the default scope is local (this project only).

claude mcp add infino \
  --scope user \
  -e INFINO_MCP_URI=/Users/me/.infino/memory \
  -- npx -y @infino-ai/mcp-server

Add more knobs with repeated -e flags, e.g. -e INFINO_MCP_ENABLE_WRITES=true. Verify with:

claude mcp list
claude mcp get infino

Claude Desktop

Edit the configuration file (create it if it doesn't exist), then fully restart Claude Desktop.

OS	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

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

Cursor

Add the server to ~/.cursor/mcp.json (available in all projects) or <project>/.cursor/mcp.json (this project only), then reload. The format matches Claude Desktop: