soul-mcp-server

soul-mcp-server

SOUL.md 用の MCP サーバーです。Claude Desktop または MCP 対応クライアントから、ソウルファイルを直接検証・生成できます。

Agenturo 向けに構築されています。Agenturo は SOUL.md のリファレンス実装です。ソウルファイルを、ご自身のサブドメイン上で稼働するエージェントとしてデプロイできます。

---

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 を再起動します。ツール一覧に 3 つのソウルツールが表示されます。

---

ツール

validate_soul_file

.soul.md ファイルを SOUL.md スキーマに照らして検証します。

パラメーター：

• path（string、必須）— ソウルファイルへのパス

戻り値： pass の真偽値、name、version、errors 配列を含む JSON です。

プロンプトの例：

「~/agents/marcus.soul.md にあるソウルファイルを検証してください」

---

generate_soul_template

指定したエージェント名とキーワードに基づいて、スターター用の .soul.md を生成します。

パラメーター：

• name（string、必須）— エージェント名
• keywords（string[]、任意）— テンプレートの初期内容に使う分野のキーワード

戻り値： そのまま編集できるソウルファイルの文字列です。

プロンプトの例：

「二酸化炭素回収を専門とする気候科学者向けのソウルテンプレートを生成してください」

---

score_soul_file

入力済みの任意フィールド数に基づいて、完全性スコア（0～100）を返します。

パラメーター：

• path（string、必須）— ソウルファイルへのパス

戻り値： score、filled、missing、total を含む JSON です。

プロンプトの例：

「~/agents/startup-advisor.soul.md にあるエージェントを採点して、不足している項目を教えてください」

---

仕様とサンプル

完全な仕様：soul-spec

コミュニティで厳選されたソウルファイル：awesome-soul-files

CLI バリデーター（Claude 不要）：soul-md-cli

---

MIT License。作成者：Anton Agafonov。