Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (taru-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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:

Project folder name — creates the workspace directory
AI client — Claude Code, Codex, or both
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