mcpField
S
soul-mcp-server

soul-mcp-server

本地服务
github.com/AntonioTF5AI 与智能体228 周前更新
代码仓库

关于 soul-mcp-server

soul-mcp-server 提供用于校验和创建 SOUL.md Agent 身份文件的 MCP 工具，适合需要定义 Agent 身份的用户。Claude Desktop 或其他 MCP 客户端可用于检查模式、评估完整度并生成模板。

主要功能

  1. 01按模式校验 `.soul.md` 文件
  2. 02生成可编辑的身份模板
  3. 03根据可选字段评估文件完整度

适用场景

  1. 01检查 SOUL.md 文件的模式错误
  2. 02为 Agent 创建身份文件模板
  3. 03查找身份文件中缺少的可选字段

MCP 相关

向 MCP 客户端提供三个工具：`validate_soul_file`、`generate_soul_template` 和 `score_soul_file`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "antoniotf5-soul": {
      "command": "npx",
      "args": [
        "-y",
        "soul-mcp-server"
      ]
    }
  }
}
启动命令npx -y soul-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmsoul-mcp-server1.0.0

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
pathstring是要验证的 .soul.md 文件路径。

详细介绍

soul-mcp-server

License: MIT

适用于 SOUL.md 的 MCP 服务——可直接通过 Claude Desktop 或任何兼容 MCP 的客户端验证和生成 soul 文件。

为 Agenturo 构建——SOUL.md 的参考实现。将你的 soul 文件部署为自有子域名上的在线 Agent。

30 秒快速设置

将以下内容添加到你的 claude_desktop_config.json（在 macOS 上通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "soul-md-cli": {
      "command": "npx",
      "args": ["soul-mcp-server"]
    }
  }
}

重启 Claude Desktop。三个 soul 工具将显示在工具列表中。

工具

validate_soul_file

根据 SOUL.md 架构验证 .soul.md 文件。

参数：

  • path（string，必填）——soul 文件的路径

**返回：**包含 pass 布尔值、name、version 和 errors 数组的 JSON。

示例提示词：

“验证我位于 ~/agents/marcus.soul.md 的 soul 文件”

generate_soul_template

根据指定的 Agent 名称和关键词生成一个初始 .soul.md 文件。

参数：

  • name（string，必填）——Agent 的名称
  • keywords（string[]，可选）——用于填充模板的领域关键词

**返回：**可直接编辑的 soul 文件字符串。

示例提示词：

“为一位专攻碳捕集的气候科学家生成 soul 模板”

score_soul_file

根据已填写的可选字段数量，返回完整度评分（0–100）。

参数：

  • path（string，必填）——soul 文件的路径

**返回：**包含 score、filled、missing 和 total 的 JSON。

示例提示词：

“为我位于 ~/agents/startup-advisor.soul.md 的 Agent 评分，并告诉我还缺少什么”

规范与示例

完整规范：soul-spec

精选社区 soul 文件：awesome-soul-files

CLI 验证器（无需 Claude）：soul-md-cli

MIT 许可证。由 Anton Agafonov 创建。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。