ravelry-mcp

Ravelry API에 Claude를 연결하는 MCP 서버로, 뜨개질과 코바늘 뜨개질을 하는 사람들이 자연어를 사용해 작업 흐름을 벗어나지 않고 패턴 검색, 실 찾기, 구매할 양 계산을 할 수 있게 해줍니다.

도구

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에서 프로 → 앱 → 개인 앱 만들기로 이동하면 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

로드맵

다음 기능은 Basic Auth 대신 OAuth(사용자 수준 액세스)가 필요합니다:

• 스태시 매칭 — 사용자의 보유 실(스태시)을 패턴 요구 사항과 대조하여 검색

• 큐 액세스 — 사용자의 패턴 큐를 읽고 관리

• 프로젝트 진행 추적기 — 진행 중인 뜨개질 프로젝트를 기록하고 업데이트