Ravelry MCP Server
2025.03.19
0
编织图案搜索AI 助手集成内容生成
Ravelry MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为 AI 助手提供与 Ravelry API 交互的能力，帮助用户搜索、浏览和获取编织和钩针图案。该项目的灵感来源于对编织和钩针艺术的兴趣，旨在通过技术手段增强而非取代手工制作的体验。
View on GitHub
Overview
基本能力
产品定位
Ravelry MCP Server 是一个桥梁，连接 AI 助手和 Ravelry 编织社区，使得 AI 能够帮助用户搜索和获取编织图案。
核心功能
- 🔍 图案搜索：使用关键词和过滤器搜索 Ravelry 数据库中的图案
- 📋 图案详情：获取特定图案的详细信息
- 🧶 工艺过滤：按工艺类型（编织或钩针）过滤图案
- 💰 价格选项：按可用性（免费、付费等）过滤图案
- 🤖 AI 助手集成：通过 MCP 协议与 AI 助手集成
适用场景
- 为编织爱好者提供图案搜索和浏览功能
- 帮助 AI 助手回答关于编织图案的查询
- 教育和学习编织的新手
工具列表
search-patterns：根据查询参数搜索图案get-pattern-details：获取特定图案的详细信息get-multiple-pattern-details：一次性获取多个图案的详细信息
常见问题解答
- 确保 Node.js 版本为 v14 或更高
- 确保已正确配置 Ravelry API 凭证
- 确保 MCP 服务器运行并可被 Claude Desktop 访问
使用教程
使用依赖
- Node.js (v14 或更高)
- npm 或 yarn
- Ravelry API 凭证（用户名和密码）
安装教程
-
克隆仓库
bash git clone <repository-url> cd ravelry-mcp -
安装依赖
bash npm install -
设置环境变量
bash cp .env.example .env.development cp .env.example .env.production -
配置 API 凭证
- 获取 Ravelry 用户名和密码
- 将凭证添加到
.env.development和.env.production文件
调试方式
-
开发模式
bash npm run dev -
生产模式
bash npm run build npm start -
集成 Claude Desktop
- 启动 MCP 服务器
- 在 Claude Desktop 设置中添加自定义 MCP
- 配置 MCP 连接并启用
- 验证连接并开始使用