MCP Dev Journal

塔耳塔罗斯

一个双界面平台（MCP服务器+web应用程序），用于结构化、人工智能驱动的日志记录、项目文档和个人知识管理。

这是什么

1. MCP服务器 (src/)-22个工具、24个资源和3个AI代理提示（Claude Code、Cursor等），用于创建日记条目、管理项目摘要、查询文档以及与Linear交互
2. Tartarus网络应用程序 (web/)-带有人工智能聊天（Kronus）、期刊阅读器、文本校正、翻译和统一知识库的深色主题仪表板

主要特点

• 结构化日记账分录 链接到带有AI生成摘要的git提交
• 条目0 v2（生活项目摘要） -模式驱动的项目文档，具有部分历史跟踪和浅/深视图
• Kronus聊天 -具有35个集成工具的多模型AI对话（Gemini 3 Pro/Flash、Claude Opus 4.5/4.6、Claude Haiku 4.5、GPT-5.2）
• Kronus技能 -按需加载上下文（开发人员、作家、求职者、全能者）——启动精益，在需要时加载上下文
• 阿特洛波斯 -AI拼写检查器和文本校正，带内联差异视图
• 赫尔墨斯 -AI翻译工具
• 仓库 -写作、提示、笔记、简历（技能、经验、教育）和作品集项目的统一知识库
• 线性积分 -同步线性项目和手动+自动小时同步问题
• 媒体库 -链接到条目或独立的图像、图表、PDF
• Git集成 -只读GitHub/GitLab仓库浏览（文件树、文件内容）
• 可观测性 -人工智能使用跟踪（跟踪、令牌、成本、延迟）

建筑

┌─────────────────┐     ┌──────────────────────┐
│   AI Agents     │     │       Humans         │
│ (Claude, etc.)  │     │                      │
└────────┬────────┘     └──────────┬───────────┘
         │                         │
         ▼                         ▼
┌─────────────────┐     ┌──────────────────────┐
│   MCP Server    │     │   Tartarus Web App   │
│   (read-only)   │     │                      │
│                 │     │ • Kronus Chat (AI)    │
│ • 22 tools      │     │ • Journal Reader      │
│ • 24 resources  │     │ • Atropos / Hermes    │
│ • 3 prompts     │     │ • Repository Browser  │
│ • Kronus oracle │     │ • Linear Integration  │
│                 │     │ • Prompt Management   │
└────────┬────────┘     └──────────┬───────────┘
         │                         │
         └───────────┬─────────────┘
                     ▼
            ┌─────────────────┐
            │   SQLite DB     │
            │  (journal.db)   │
            └─────────────────┘

数据流： 线性API→ Tartarus同步→ SQLite缓存→ MCP资源（只读）。Tartarus是所有突变的唯一真理来源。

快速开始

选项1:Docker（推荐）

cp .env.example .env
# Edit .env with your API keys

docker compose up -d
# Access at http://localhost:3777

方案2：地方发展

# MCP server
npm install && npm run build

# Web app
cd web && npm install
export JOURNAL_DB_PATH="/path/to/data/journal.db"
export GOOGLE_GENERATIVE_AI_API_KEY="your-key"
npm run dev
# Access at http://localhost:3005

MCP服务器

MCP服务器是 只读 对于缓存数据，使用通过Tartarus API的写入工具。

工具（22）

期刊（10）：

存储库（9）：

克罗诺斯（3）：

资源

期刊（7）：

注册表（2）：

存储库（7）：

线性缓存（7）：

可观察性（3）：

提示（3）

Tartarus网络应用程序

页面

Kronus技能（按需环境）

Kronus开始 倾斜 （约6k个令牌）——只是灵魂提示和写入协议。上下文和工具通过技能按需加载，这些技能作为文档存储在数据库中(type="prompt", metadata.type="kronus-skill").

技能叠加——激活多个技能通过OR逻辑合并它们的上下文。不可能有冲突。

新技能可以添加到数据库中——Kronus在运行时动态地发现它们。

聊天模特

关键概念

条目0 v2（生活项目摘要）

每个项目都有一个模式驱动的、不断发展的知识库。编码代理是扫描器——它直接填充模式，不需要人工智能规范化。

架构： 每个部分都承载 current 状态+进化 history[] 带有时间戳和提交参考。

第1级（必填）： file_structure, tech_stack, patterns, commands, architecture

第2级（可选）： frontend, backend, database_info, services, data_flow

第3级（可选）： custom_tooling, purpose, summary

叙述部分 （通过Kronus更新）： summary, purpose, key_decisions, technologies, status, extended_notes

两种观点：

• 浅 (journal://project-summary/{repo})--电流值平坦，对LLM上下文令牌高效
• 深 (journal://project-summary/{repo}/deep)--每个部分的完整历史时间线

日记账条目结构

Repository (e.g., "my-project")
  └── Branch (e.g., "main")
      └── Entry (commit_hash: "abc1234")
          ├── why, what_changed, decisions
          ├── technologies, kronus_wisdom
          └── files_changed: [{ path, action, diff_summary }]

文档类型

文档有两级分类：

• 主要类型: writing, prompt, note
• 标签：中的其他标签 metadata.tags

配置

环境变量

# AI Providers (at least one required for Kronus chat)
GOOGLE_GENERATIVE_AI_API_KEY=your-key    # Gemini 3 Pro/Flash
ANTHROPIC_API_KEY=your-key                # Claude Opus/Haiku
OPENAI_API_KEY=your-key                   # GPT-5.2

# Database
JOURNAL_DB_PATH=/path/to/journal.db       # Optional, defaults to ./data/journal.db

# Web App URL (for MCP → Tartarus API calls)
TARTARUS_URL=http://localhost:3005

# Optional integrations
LINEAR_API_KEY=lin_api_...                # Linear project management
MCP_API_KEY=your-mcp-key                  # Authenticated MCP requests
GITHUB_TOKEN=ghp_...                      # GitHub repo browsing
GITLAB_TOKEN=glpat-...                    # GitLab repo browsing
GITLAB_HOST=https://gitlab.com            # GitLab instance URL

# Optional AI features
REPLICATE_API_TOKEN=r8_...                # Image generation (FLUX, Imagen)
PERPLEXITY_API_KEY=pplx-...              # Web search

# Agent Configuration
AGENT_NAME=Kronus                         # Name of your AI agent (default: "Kronus")
AGENT_SOUL_PATH=Soul.xml                 # Path to agent personality file

MCP客户端设置

从开发人员日志迁移： 将MCP客户端配置更新到密钥 tartarus，点 args 在这个回购 dist/index.js （之后 npm run build)，并使用 tartarus 如果全局链接，则使用npm二进制。确保根 name 是 tartarus-workspace --MCP服务器从该字段解析monorepo根；旧名称 developer-journal-workspace 在代码中不再被识别。

克劳德桌面/光标/VS代码/克劳德代码：

{
  "mcpServers": {
    "tartarus": {
      "command": "node",
      "args": ["/absolute/path/to/your-clone/dist/index.js"]
    }
  }
}

特定于平台的配置位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• 光标: ~/.cursor/mcp.json
• 克劳德代码: ~/.claude/settings.json

代理配置

系统支持自定义AI代理名称和个性文件。

• AGENT_NAME：您的AI代理的名称（默认：“Kronus”）
• AGENT_SOUL_PATH：代理提示文件的路径（默认：“Soul.xml”）

Soul文件定义了代理的个性、沟通风格、知识框架和交互协议。名称显示在整个UI中（聊天、上下文选择器、API响应）。

线性同步

线性数据同步到本地SQLite缓存。两种同步方法：

• 手册：技能弹出窗口中的“同步线性”按钮（高级配置部分）
• 自动（仅限macOS）：洗衣店 config/com.tartarus.linear-sync.plist 每小时运行一次 curl 反对 localhost:3005同步端点仅可从本地主机访问，无需身份验证。

要安装自动同步，请执行以下操作：

ln -sf "$(pwd)/config/com.tartarus.linear-sync.plist" ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.tartarus.linear-sync.plist

停止： launchctl unload ~/Library/LaunchAgents/com.tartarus.linear-sync.plist

日志： /tmp/tartarus-linear-sync.log

备注：自动同步要求Tartarus在端口3005上运行。如果服务器宕机，curl会悄无声息地失败——不会造成任何伤害。如果你分叉这个仓库，launchd-plist不会自动安装；请改用手动同步按钮。

发展

# MCP server
npm run build      # Build (esbuild → dist/index.js)
npm run dev        # Watch mode

# Web app
cd web
npm run dev        # Dev server on :3005
npm run build      # Production build

# Both (via Makefile)
make dev           # Start Tartarus dev server
make build         # Build MCP server

# Docker
docker compose up -d --build
docker compose logs -f tartarus

技术栈

许可证

麻省理工学院