cerebrun

Cerebrun 的 MCP 客户端 - 全面的个人上下文和内存管理系统。检索用户上下文层（语言、项目、身份、库）、执行语义搜索、管理知识库并与 LLM Gateway 交互。在以下情况下使用：(1) 检索用户首选项或上下文，(2) 搜索用户的知识库，(3) 管理项目和目标，(4) 存储或查询个人信息，(5) 通过 LLM Gateway 访问对话历史记录

# Cerebrun MCP Client

Cerebrun (cereb.run) is a Model Context Protocol (MCP) server that provides persistent personal context management across sessions.

## Quick Start

All requests require:
- `api_key`: Cerebrun API key (Bearer token)
- `base_url`: https://cereb.run/mcp

## Context Layers

**Layer 0** - Language, timezone, comms prefs
**Layer 1** - Projects, goals, pinned memories
**Layer 2** - Personal identity info, API and other keys
**Layer 3** - Encrypted vault (requires consent)

## Usage

### Get Context
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_context","arguments":{"layer":0}}}' \
  https://cereb.run/mcp

### Search Context
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_context","arguments":{"query":"Rust authentication","limit":5}}}' \
  https://cereb.run/mcp

### Push Knowledge
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"push_knowledge","arguments":{"content":"Important insight","category":"learning","tags":["rust","performance"]}}}' \
  https://cereb.run/mcp

### Chat via Gateway
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"chat_with_llm","arguments":{"message":"Hello","provider":"openai","model":"gpt-4"}}}' \
  https://cereb.run/mcp

## Tools Reference

See [REFERENCES.md](references/REFERENCES.md) for complete API documentation.

## Script Usage

```python
scripts/cerebrun.py get_context --layer 0 --api-key YOUR_KEY
scripts/cerebrun.py search_context --query "project" --api-key YOUR_KEY
scripts/cerebrun.py push_knowledge --content "New idea" --category "todo" --api-key YOUR_KEY
```

## Configuration

Store API key in environment: `CEREBRUN_API_KEY` or pass via `--api-key`

---

## 中文说明

# Cerebrun MCP 客户端

Cerebrun (cereb.run) 是一个模型上下文协议（MCP）服务器，可在多个会话之间提供持久化的个人上下文管理。

## 快速开始

所有请求都需要：
- `api_key`：Cerebrun API 密钥（Bearer token）
- `base_url`：https://cereb.run/mcp

## 上下文层

**Layer 0** - 语言、时区、通讯偏好
**Layer 1** - 项目、目标、置顶记忆
**Layer 2** - 个人身份信息、API 及其他密钥
**Layer 3** - 加密保险库（需要同意授权）

## 用法

### 获取上下文
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_context","arguments":{"layer":0}}}' \
  https://cereb.run/mcp

### 搜索上下文
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_context","arguments":{"query":"Rust authentication","limit":5}}}' \
  https://cereb.run/mcp

### 推送知识
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"push_knowledge","arguments":{"content":"Important insight","category":"learning","tags":["rust","performance"]}}}' \
  https://cereb.run/mcp

### 通过 Gateway 对话
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"chat_with_llm","arguments":{"message":"Hello","provider":"openai","model":"gpt-4"}}}' \
  https://cereb.run/mcp

## 工具参考

完整的 API 文档请参见 [REFERENCES.md](references/REFERENCES.md)。

## 脚本用法

```python
scripts/cerebrun.py get_context --layer 0 --api-key YOUR_KEY
scripts/cerebrun.py search_context --query "project" --api-key YOUR_KEY
scripts/cerebrun.py push_knowledge --content "New idea" --category "todo" --api-key YOUR_KEY
```

## 配置

将 API 密钥存储在环境变量中：`CEREBRUN_API_KEY`，或通过 `--api-key` 传入