taru-mcp

MCP server for taru — connect Claude Code or Codex to your team's shared knowledge graph.

Zero dependencies. Pure Node.js. Works with any MCP client.

Quick Setup

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/arupa-inc/taru-mcp/main/setup.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/arupa-inc/taru-mcp/main/setup.ps1 | iex

The script will ask you:

1. Project folder name — creates the workspace directory
2. AI client — Claude Code, Codex, or both
3. Workspace token — taru workspace token (xxv_...). Can be entered later if you don't have it yet.

It handles npm init, taru-mcp installation, agent file (CLAUDE.md / AGENTS.md) setup, and MCP registration automatically.

Get your workspace token from the taru web console: Settings > API Key.

Manual Setup

If the setup script doesn't work, follow these steps:

1. Install

mkdir my-project && cd my-project
npm init -y
npm install taru-mcp

2. Copy agent instructions

# For Claude Code
cp node_modules/taru-mcp/samples/CLAUDE.md ./CLAUDE.md

# For Codex
cp node_modules/taru-mcp/samples/AGENTS.md ./AGENTS.md

3. Register MCP server

# Claude Code
claude mcp add taru -- node node_modules/taru-mcp/bin/taru-mcp.mjs --token xxv_your_token

# Codex
codex mcp add taru -- node node_modules/taru-mcp/bin/taru-mcp.mjs --token xxv_your_token

4. Or configure MCP manually

If claude mcp add doesn't work, create .mcp.json in your project root:

{
  "mcpServers": {
    "taru": {
      "command": "node node_modules/taru-mcp/bin/taru-mcp.mjs",
      "args": ["--token", "xxv_your_token"]
    }
  }
}

For Claude Code global config (~/.claude.json):

{
  "mcpServers": {
    "taru": {
      "command": "node node_modules/taru-mcp/bin/taru-mcp.mjs",
      "args": ["--token", "xxv_your_token"]
    }
  }
}

Tools

Once connected, these MCP tools are available to the AI:

Tool	Description
search_graph	Search the knowledge base by natural language query
read_full_document	Read full document content by UUID
store_document	Store a document or opinion with auto-conflict detection
list_documents	List all documents in the workspace
list_conflicts	View pending knowledge conflicts
rebalance	Merge similar keywords, clean up orphan nodes

How it works

taru-mcp is a thin proxy: it reads JSON-RPC (MCP protocol) from stdin, forwards each request to the taru server over HTTP, and writes the response to stdout. No database, no AI calls — just I/O.

MCP Client (Claude/Codex)
    ↕ stdin/stdout (JSON-RPC)
taru-mcp (this package)
    ↕ HTTP POST
Taru Server (knowledge graph + embeddings + graph DB)

License

MIT