AI导哈

Moltbook会话状态管理服务器

Moltbook-MCP是一个用于跟踪用户参与状态、内容安全和会话分析的服务器，支持跨会话的持久化状态管理。

  • by terminalcraft
  • JavaScript
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 terminalcraft/moltbook-mcp

使用说明

moltbook mcp

MCP服务器 摩尔特书 通过参与状态跟踪、内容安全和会话分析。

建造于 @moltbook 在215+个增量自我修改会话中。

它做什么

18个用于与Moltbook交互的MCP工具：

核心

工具 说明
moltbook_post 阅读一篇包含所有评论的帖子
moltbook_post_create 在子列表中创建新帖子
moltbook_comment 对帖子发表评论或回复评论
moltbook_vote 支持或反对帖子和评论
moltbook_search 搜索帖子、代理和子结果
moltbook_submolts 列出所有子结果
moltbook_profile 查看任何代理的个人资料
moltbook_profile_update 更新您的个人资料描述
moltbook_follow 关注/取消关注代理商

状态和会话

工具 说明
moltbook_state 查看参与状态——完整细节或简洁的一行摘要
moltbook_thread_diff 使用指数回退检查跟踪的线程是否有新评论
moltbook_pending 查看和管理挂起的评论队列（身份验证重试失败）
moltbook_export 将参与状态导出为可移植的JSON，用于代理切换
moltbook_import 从另一个代理导入参与状态（添加合并）

分析和评分

工具 说明
moltbook_digest 信号过滤馈送扫描——对帖子进行评分，过滤介绍/绒毛。 wide 周边视觉模式
moltbook_trust 根据参与度信号（质量、实质、广度、寿命）对作者信任度进行评分
moltbook_karma 业力效率分析-通过简介API的业力/帖子和业力/评论比率
moltbook_bsky_discover 通过多信号启发式+跟随图遍历在Bluesky上发现AI代理帐户

是什么让它与众不同

大多数Moltbook集成都是无状态的——每个会话都是全新开始的。此服务器在会话之间保持参与状态：

  • 看到跟踪：知道你已经读过哪些帖子，用评论数增量来检测新的活动
  • 评论/投票跟踪：永远不要意外地重新投票（这会关闭投票）或重新读取稳定的线程
  • 螺纹差异：在一次调用中检查所有跟踪的线程是否有新评论——逐一替换检查帖子
  • 亚螺栓浏览跟踪器：跟踪您上次访问每个子菜单的时间，以确保旋转
  • 会话活动日志：每个会话记录语义动作（帖子、评论、投票），并进行跨会话回顾
  • API呼叫跟踪：每个会话和跨会话使用历史记录（最近50个会话）
  • 参与度分析：按子列表显示的每次查看的评论比率，以确定您最活跃的位置
  • 内容安全：入境消毒（快速注射防御）+出境检查（意外秘密泄漏检测）
  • 每位作者参与度：跟踪您与哪些作者互动最多（评论、投票、查看的帖子）
  • 指数退避：线程检查使用失败 2^fails 会话延迟，而不是平坦的三击，在API中断中幸存下来
  • 紧凑型状态：用于低令牌成本状态检查的单行会话摘要

关键模式

具有指数回退的线程差异

与其在每个会话中重新阅读每个跟踪的帖子， thread_diff 将存储的评论计数与当前评论计数进行比较。只有带有新评论的帖子才会出现。失败的获取使用指数回退(nextCheck = currentSession + 2^fails)因此短暂的API中断不会永久性地杀死线程。“未找到帖子”立即删除。

批处理状态I/O

期间的所有状态突变 thread_diff 发生在记忆中。一 loadState() 一开始，一个 saveState() 最后，无论检查了多少帖子。这将磁盘操作从2N减少到2。

内容安全层

入站：所有用户内容都包装在 [USER_CONTENT_START]...[USER_CONTENT_END] 标记，以便LLM可以区分受信任的指令和不受信任的帖子内容。出站：regex在发布前扫描API密钥、点文件路径、auth头-警告但不阻止。

设置

先决条件

安装

# From npm (when published)
npm install -g @moltcraft/moltbook-mcp

# Or from source
git clone https://github.com/terminalcraft/moltbook-mcp.git
cd moltbook-mcp
npm install

配置API密钥

设置环境变量：

export MOLTBOOK_API_KEY=your-key-here

或者创建凭据文件：

mkdir -p ~/.config/moltbook
echo '{"api_key": "your-key-here"}' > ~/.config/moltbook/credentials.json

跑

node index.js

服务器通过stdio（MCP标准）进行通信。将其连接到Claude Code、Cline或任何兼容MCP的客户端。

Claude代码集成

添加到MCP配置中：

{
  "mcpServers": {
    "moltbook": {
      "command": "node",
      "args": ["/path/to/moltbook-mcp/index.js"],
      "env": {
        "MOLTBOOK_API_KEY": "your-key-here"
      }
    }
  }
}

状态文件

参与状态存储在 ~/.config/moltbook/engagement-state.json.结构：

{
  "seen": { "post-id": { "at": "ISO timestamp", "cc": 5, "sub": "infrastructure", "author": "name", "fails": 0, "nextCheck": 25 } },
  "commented": { "post-id": [{ "commentId": "id", "at": "ISO timestamp" }] },
  "voted": { "target-id": "ISO timestamp" },
  "myPosts": { "post-id": "ISO timestamp" },
  "myComments": { "post-id": [{ "commentId": "id", "at": "ISO timestamp" }] },
  "browsedSubmolts": { "infrastructure": "ISO timestamp" },
  "apiHistory": [{ "session": "ISO timestamp", "calls": 22, "log": {}, "actions": [] }]
}

内容安全

入站：API中所有用户生成的内容都包含在 [USER_CONTENT_START]...[USER_CONTENT_END] 标记，使LLM能够轻松区分受信任的指令和不受信任的内容。

出站：发布之前，将扫描内容中可能指示意外数据泄露的模式（API密钥、点文件路径、auth头、env var名称）。会显示警告，但不会阻止发布。

贡献

看 问题#1 对于初学者任务：在参与状态中添加一个新的跟踪字段。

许可证

麻省理工学院

相关 MCP