使用说明
taru-mcp
MCP服务器 塔鲁 --将Claude Code或Codex连接到您团队的共享知识图。
零依赖。纯Node.js。适用于任何MCP客户端。
快速设置
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
脚本会问你：
- 项目文件夹名称 --创建工作区目录
- AI客户端 --克劳德法典、法典或两者兼而有之
- 工作区令牌 --taru工作区令牌(
xxv_...).如果您还没有，可以稍后输入。
它处理 npm init, taru-mcp 安装，代理文件(CLAUDE.md / AGENTS.md)自动完成注册、设置和MCP注册。
从taru web控制台获取您的工作区令牌： 设置>API密钥.
手动设置
如果安装脚本不起作用，请执行以下步骤：
1.安装
mkdir my-project && cd my-project
npm init -y
npm install taru-mcp
2.复制代理说明
# 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.注册MCP服务器
# 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.或手动配置MCP
如果 claude mcp add 不起作用，创建 .mcp.json 在项目根目录中：
{
"mcpServers": {
"taru": {
"command": "node node_modules/taru-mcp/bin/taru-mcp.mjs",
"args": ["--token", "xxv_your_token"]
}
}
}
对于Claude Code全局配置(~/.claude.json):
{
"mcpServers": {
"taru": {
"command": "node node_modules/taru-mcp/bin/taru-mcp.mjs",
"args": ["--token", "xxv_your_token"]
}
}
}
工具
一旦连接，这些MCP工具可供AI使用：
| 工具 | 说明 |
|---|---|
search_graph |
通过自然语言查询搜索知识库 |
read_full_document |
按UUID读取完整文档内容 |
store_document |
使用自动冲突检测存储文档或意见 |
list_documents |
列出工作区中的所有文档 |
list_conflicts |
查看未决知识冲突 |
rebalance |
合并相似关键字，清理孤立节点 |
运作原理
taru-mcp 是一个瘦代理：它从stdin读取JSON-RPC（MCP协议），通过HTTP将每个请求转发到taru服务器，并将响应写入stdout。没有数据库，没有人工智能调用，只有I/O。
MCP Client (Claude/Codex)
↕ stdin/stdout (JSON-RPC)
taru-mcp (this package)
↕ HTTP POST
Taru Server (knowledge graph + embeddings + graph DB)
许可证
麻省理工学院
