English Français العربية

io.github.AntonioTF5/soul-mcp-server

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP server for validating and generating SOUL.md agent identity files from Claude Desktop.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package soul-mcp-server
Claude Code 
claude mcp add soul-mcp-server -- npx -y soul-mcp-server@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "soul-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "soul-mcp-server@1.0.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. soul-mcp-server
  2. 30-second setup
  3. Tools
  4. Spec & examples

soul-mcp-server

MCP server for SOUL.md — validate and generate soul files directly from Claude Desktop or any MCP-compatible client.

Built for Agenturo — the reference SOUL.md implementation. Deploy your soul file as a live agent on your own subdomain.

30-second setup

Add this to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Restart Claude Desktop. The three soul tools will appear in your tool list.

Tools

validate_soul_file

Validates a .soul.md file against the SOUL.md schema.

Parameters:

  • path (string, required) — path to the soul file

Returns: JSON with pass boolean, name, version, and errors array.

Example prompt:

"Validate my soul file at ~/agents/marcus.soul.md"

generate_soul_template

Generates a starter .soul.md for a given agent name and keywords.

Parameters:

  • name (string, required) — the agent's name
  • keywords (string[], optional) — domain keywords to seed the template

Returns: A ready-to-edit soul file as a string.

Example prompt:

"Generate a soul template for a climate scientist who specializes in carbon capture"

score_soul_file

Returns a completeness score (0–100) based on how many optional fields are filled.

Parameters:

  • path (string, required) — path to the soul file

Returns: JSON with score, filled, missing, and total.

Example prompt:

"Score my agent at ~/agents/startup-advisor.soul.md and tell me what's missing"

Spec & examples

Full specification: soul-spec

Curated community soul files: awesome-soul-files

CLI validator (no Claude required): soul-md-cli

MIT License. Created by Anton Agafonov.

الأسئلة الشائعة

ما هو io.github.AntonioTF5/soul-mcp-server؟

MCP server for validating and generating SOUL.md agent identity files from Claude Desktop.

كيف أثبّت io.github.AntonioTF5/soul-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add soul-mcp-server -- npx -y soul-mcp-server@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.AntonioTF5/soul-mcp-server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.AntonioTF5/soul-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.AntonioTF5/soul-mcp-server؟

ينشره AntonioTF5. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.