English Français العربية

io.github.AntonioTF5/soul-mcp-server

Registre officiel IA et agents

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que io.github.AntonioTF5/soul-mcp-server ?

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

Comment installer io.github.AntonioTF5/soul-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add soul-mcp-server -- npx -y soul-mcp-server@1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.AntonioTF5/soul-mcp-server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.AntonioTF5/soul-mcp-server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.AntonioTF5/soul-mcp-server ?

Il est publié par AntonioTF5. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.