ravelry-mcp

MCP-сервер, который подключает Claude к API Ravelry, позволяя всем, кто вяжет спицами или крючком, искать схемы, находить пряжу и рассчитывать, сколько её купить, — всё через естественный язык, не покидая рабочего процесса.

Инструменты

Related MCP server: agent-skill-loader

Необходимые условия

• Python 3.11+

• uv

• Аккаунт разработчика Ravelry с личным приложением (для учётных данных Basic Auth)

Настройка

git clone https://github.com/alicegetmanchuk/ravelry-mcp-project.git ravelry-mcp
cd ravelry-mcp
uv pip install -e .
cp .env.example .env

Отредактируйте .env, указав свои учётные данные Ravelry:

RAVELRY_USERNAME=your_username
RAVELRY_PASSWORD=your_personal_auth_token

Примечание: v0 требуется только доступ на чтение через Basic Auth. На Ravelry перейдите в Pro → Apps → «Создать личное приложение» — это даст вам имя пользователя и пароль-токен без настройки OAuth.

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "ravelry": {
      "command": "uv",
      "args": ["run", "ravelry-mcp"],
      "cwd": "/path/to/ravelry-mcp"
    }
  }
}

Разработка

Запустите MCP inspector для интерактивного тестирования инструментов:

uv run mcp dev src/ravelry_mcp/server.py:mcp

Дорожная карта

Следующие функции требуют OAuth (доступ на уровне пользователя), а не Basic Auth:

• Подбор по запасам — поиск по запасам пряжи пользователя на соответствие требованиям схемы

• Доступ к очереди — чтение и управление очередью схем пользователя

• Отслеживание прогресса проектов — запись и обновление текущих проектов вязания