ravelry-mcp

Claude を Ravelry API に接続する 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 で、Pro → Apps → Create a personal app に進みます。これにより、OAuth の設定なしでユーザー名とパスワードのトークンが取得できます。

Claude Desktop

claude_desktop_config.json に追加してください：

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

開発

MCP インスペクターを実行して、ツールを対話的にテストしてください：

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

ロードマップ

以下の機能は、Basic Auth ではなく OAuth（ユーザーレベルのアクセス）を必要とします：

• ストック照合 — ユーザーの糸ストックをパターンの要件と照合する

• キューアクセス — ユーザーのパターンキューを読み取りおよび管理する

• プロジェクト進捗トラッカー — 進行中の編み物プロジェクトを記録および更新する