Skip to main content
Glama

ravelry-mcp

Claude を Ravelry API に接続する MCP サーバーです。ニットやかぎ針編みの愛好家が、パターンを検索したり、糸を見つけたり、購入量を計算したりできるようにします。ワークフローを離れることなく、すべて自然言語で行えます。

ツール

ツール

説明

search_patterns

キーワード、クラフト、糸の太さ、難易度、価格で Ravelry のパターンを検索します。

get_pattern_details

パターンの全詳細(糸の長さ、ゲージ、サイズ、直接リンクを含む)を取得します。

search_yarn

名前、ブランド、太さ、または繊維の含有量で Ravelry の糸データベースを検索します。

calculate_yarn_needed

特定の糸がパターンに必要な玉数を、余裕を持たせて計算します。

Related MCP server: agent-skill-loader

前提条件

セットアップ

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(ユーザーレベルのアクセス)を必要とします:

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

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers