taru-mcp
MCP服务器 塔鲁 --将Claude Code或Codex连接到您团队的共享知识图。
零依赖。纯Node.js。适用于任何MCP客户端。
快速设置
macOS/Linux```bash
curl -fsSL https://raw.githubusercontent.com/arupa-inc/taru-mcp/main/setup.sh | bash
### Windows（PowerShell）```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.安装```bash
mkdir my-project && cd my-project
npm init -y
npm install taru-mcp
### 2.复制代理说明```bash
# 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服务器```bash
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` 在项目根目录中：```json
{
"mcpServers": {
"taru": {
"command": "node node_modules/taru-mcp/bin/taru-mcp.mjs",
"args": ["--token", "xxv_your_token"]
}
}
}
对于Claude Code全局配置(~/.claude.json):```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)
许可证
麻省理工学院
