AI导哈

AI代理角色管理与记忆工具

ClawSouls MCP Server提供AI代理角色管理、安全验证和记忆工具，支持多种MCP兼容客户端。

  • by clawsouls
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 clawsouls/clawsouls-mcp

使用说明

ClawSouls MCP服务器

AI代理角色管理、安全验证和记忆工具 模型上下文协议.

9工具 适用于Claude Code、OpenClaw和任何兼容MCP的客户端。

快速安装（Claude代码）

# Install the ClawSouls plugin (includes MCP server)
/plugin marketplace add https://github.com/clawsouls/clawsouls-claude-code-plugin
/plugin install clawsouls
/reload-plugins

或者直接添加到您的 .mcp.json:

{
  "mcpServers": {
    "clawsouls": {
      "command": "npx",
      "args": ["-y", "clawsouls-mcp@latest"]
    }
  }
}

与OpenClaw一起使用

OpenClaw通过以下方式消耗MCP服务器 麦克波特.通过stdio临时调用ClawSouls工具：

mcporter call --stdio "npx -y clawsouls-mcp@latest" soul_search query="chief of staff"
mcporter list --stdio "npx -y clawsouls-mcp@latest" --schema

要坚持下去，请添加 .mcp.json 将下面的块添加到文件中并导入：

mcporter config import ./.mcp.json

（参见 mcporter.dev 查看完整的配置选项。)

与Hermes代理商/Cursor/Windsurf/任何MCP客户一起使用

通过相同的stdio命令 .mcp.json-样式配置：

{
  "mcpServers": {
    "clawsouls": {
      "command": "npx",
      "args": ["-y", "clawsouls-mcp@latest"]
    }
  }
}

工具

🎭 人物管理

工具 说明
soul_search 按关键字、类别或标签搜索AI代理角色
soul_get 获取特定角色的详细信息
soul_install 下载角色并生成CLAUDE.md

🔍 安全与诚信

工具 说明
soul_scan SoulScan——根据53种模式验证角色安全性（安全等级+建议）
soul_rollback_check 通过比较当前文件与基线文件来检测角色漂移

🧠 蜂群记忆

工具 说明
memory_search TF-IDF+BM25 在MEMORY.md+MEMORY/*.md上进行排名搜索
memory_detail 获取特定内存段的完整内容（3层步骤2）
memory_status 显示内存文件清单、大小和git状态
memory_sync 基于Git的多代理内存同步（初始化/推送/拉取/状态）

记忆搜索

TF-IDF+BM25排名（默认--免费）

memory_search query="SDK version fix"

返回一个按相关性排序的紧凑索引（每个结果约50个标记）：

| # | Location              | Section          | Score |
|---|-----------------------|------------------|-------|
| 1 | memory/2026-03-31.md:5 | SDK 버전 문제 해결 | 2.41  |
| 2 | MEMORY.md:42          | Troubleshooting   | 1.87  |

增强模式（更多令牌，更多上下文）

memory_search query="SDK version fix" enhanced=true

返回完整的片段，并显示顶部结果的分数可视化。

3层工作流（令牌高效）

Step 1: memory_search query="bug fix"        → compact index with scores
Step 2: memory_detail file="memory/2026-03-31.md" line=5  → full section
Step 3: (optional) memory_search enhanced=true  → deep dive

与加载所有内存文件相比，可节省约10倍的令牌。

Swarm内存同步

通过Git跨多个代理共享内存：

# Initialize (one time)
memory_sync action=init repo_url=git@github.com:user/agent-memory.git

# Push local changes
memory_sync action=push agent_name=brad

# Pull from other agents
memory_sync action=pull

# Check sync status
memory_sync action=status

兼容的文件夹结构

适用于 龙虾的内存布局：

MEMORY.md              # Long-term curated memory
memory/
  topic-*.md           # Project-specific status/decisions/history
  YYYY-MM-DD.md        # Daily logs

平台

平台 集成
克劳德代码 插件+MCP-- /clawsouls:* 命令
龙虾 MCP工具通过 麦克波特 +原生SOUL.md支持
赫尔墨斯代理 MCP服务器通过 .mcp.json
光标/风帆 MCP服务器通过 .mcp.json
任何MCP客户端 npx -y clawsouls-mcp@latest

链接

许可证

麻省理工学院

相关 MCP