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 → 创建个人应用 — 这会为你提供一个用户名和密码令牌，无需配置 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：

• 毛线库存匹配 — 根据图案需求搜索用户的毛线库存

• 队列访问 — 读取和管理用户的图案队列

• 项目进度跟踪器 — 记录和更新进行中的编织项目