Каталог MCP
AntonioTF5/soul-mcp-server

AntonioTF5/soul-mcp-server

Name: AntonioTF5/soul-mcp-server
Availability: InStock
Author: antoniotf5

MCP-сервер для работы с SOUL.md: валидация файлов по схеме, генерация шаблонов агентов и оценка полноты. Всё доступно из Claude Desktop или любого MCP-клиента. Полезен разработчикам AI-агентов.

Github NPM Сайт сервера

README

3 инструмента

Версии

Установить сервер

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

Инструменты были проиндексированы: 21.10.2026

generate_soul_template

Генерирует файл-заготовку SOUL.md для заданного имени агента и ключевых слов.

Параметры

keywordsstring[]
Ключевые слова, описывающие область или компетенцию агента.
namestringобязательный
Имя агента.

score_soul_file

Возвращает оценку полноты (0–100) для файла SOUL.md на основе того, сколько необязательных полей заполнено.

Параметры

pathstringобязательный
Указывает путь к файлу .soul.md, который нужно оценить.

validate_soul_file

Проверяет файл SOUL.md на соответствие схеме. Возвращает результат прохождения/непрохождения и ошибки на уровне полей.

Параметры

pathstringобязательный
Путь к файлу .soul.md для проверки.

1.0.0основная

18.04.2026

Выберите клиент, чтобы установить AntonioTF5/soul-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"antoniotf5-soul-mcp-server-9o7fkacfw7\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"soul-mcp-server\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add antoniotf5-soul-mcp-server-9o7fkacfw7 -- npx soul-mcp-server

Либо через JSON-конфиг:

claude mcp add-json antoniotf5-soul-mcp-server-9o7fkacfw7 "{\"command\":\"npx\",\"args\":[\"soul-mcp-server\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add antoniotf5-soul-mcp-server-9o7fkacfw7 -- npx soul-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.antoniotf5-soul-mcp-server-9o7fkacfw7]
command = "npx"
args = ["soul-mcp-server"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите AntonioTF5/soul-mcp-server, а в поле команды запуска — строку ниже:

npx soul-mcp-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например antoniotf5-soul-mcp-server-9o7fkacfw7.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: antoniotf5-soul-mcp-server-9o7fkacfw7
    command: npx
    args:
      - "soul-mcp-server"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "antoniotf5-soul-mcp-server-9o7fkacfw7": {
      "command": "npx",
      "args": [
        "soul-mcp-server"
      ]
    }
  }
}

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 2
Форков на Github: 1
Загрузок: 1 336
Язык реализации: JavaScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 21.10 в 04:20
Идентификатор: Qjf3gfc6YgDsuVlK
Категории: Инструменты для разработчиков

Похожие MCP-сервера

davewind/mysql-mcp-server

от dave-wind

MCP сервер для безопасного read-only доступа к MySQL: позволяет LLM инспектировать схемы таблиц и выполнять SELECT-запросы. Автоматическое обнаружение структуры БД и строгая валидация только чтения — полезно для аналитики и интеграции.

ReAPI-com/mcp-openapi

официальный

от reapi-com

MCP сервер для загрузки OpenAPI спецификаций и их интеграции с LLM в IDE. Он помогает разработчикам находить операции, схемы и получать контекст для генерации кода и работы с API.

paladini/devutils-mcp-server

от paladini

DevUtils MCP сервер даёт 36 утилит для повседневных задач: хэширование, кодирование, работа с UUID, JWT, JSON, CIDR и текстом. Всё работает локально в Claude, Cursor, VS Code и других MCP-клиентах ...

glenngillen/mcpmcp-server

от glenngillen

Этот MCP сервер помогает находить, настраивать и подключать другие серверы к вашим клиентам, например Claude Desktop и другим платформам. Упрощает работу с AI, автоматизируя интеграцию и управление...

FileToPDF/filetopdf-mcp

от filetopdf

MCP сервер для конвертации файлов, HTML и Markdown в PDF через естественный язык. Поддерживает DOCX, XLSX, PPTX, изображения и веб-страницы. Использует API FileToPDF (бесплатный ключ на 10 конверсий без регистрации). Подходит для создания счетов, отчетов и документации в любом MCP-клиенте (Claude...

quantgeekdev/mongo-mcp

от quantgeekdev

MCP сервер для MongoDB: LLM выполняет запросы, инспектирует схемы и управляет документами с индексами на естественном языке. Полезен разработчикам для автоматизации работы с базами данных.