Directus Marketplace Search MCP

Directus市场搜索MCP服务器

🔍 直接从您的AI助手搜索和发现Directus扩展

一个聪明的 模型上下文协议（MCP） 服务器，使Claude、Cursor等人工智能助手能够搜索Directus市场。通过流行度指标、描述和直接链接获取Directus扩展的会话推荐。

______________________________________________________________________

🚀 用户：30秒内开始

克劳德桌面（推荐）

1. 打开您的Claude Desktop配置 在 ~/.claude/claude_desktop_config.json
2. 添加此配置:

{
  "mcpServers": {
    "directus-marketplace": {
      "command": "npx",
      "args": ["directus-marketplace-mcp"]
    }
  }
}

1. 重新启动克劳德桌面
2. 开始提问：“为我查找Directus的图表扩展名”或“最流行的Directus接口是什么？”

光标IDE

1. 打开光标设置
2. 导航到MCP设置
3. 添加服务器: npx directus-marketplace-mcp
4. 重新启动游标

其他人工智能助理

对于支持MCP的AI助手：

简单设置：

npx directus-marketplace-mcp

直接连接：

• 服务器URL: https://directus-marketplace-search-mcp.focuslab.workers.dev/mcp
• 协议：MCP流式HTTP（2024-11-052025-06-18）

______________________________________________________________________

✨ 你可以问什么

• “查找Directus的常用图表扩展名”
• “哪些接口可用于文件上传？”
• “显示最新的仪表板面板”
• “查找电子商务工作流程的扩展”
• “最受欢迎的显示扩展是什么？”

您将收到以下对话回复：

• 📊 人气指标 （下载量/月）
• 📝 清晰的描述 每个扩展的功能
• 🔗 直接链接 转到GitHub存储库和NPM包
• 🏷️ 扩展类别 和过滤

______________________________________________________________________

🆓 免费与无限

免费层（公共服务器）

• ✅ 每小时100个请求 每个IP地址
• ✅ 每天500个请求 每个IP地址
• ✅ 非常适合评估 和光使用
• ✅ 无需注册

*非常适合尝试服务和偶尔搜索*

无限（您自己的实例）

• ✅ 无费率限制 无论什么
• ✅ 在5分钟内部署
• ✅ 可能免费 在Cloudflare的慷慨限制下
• ✅ 全球领先性能

*非常适合团队、大量使用或商业项目*

______________________________________________________________________

🔄 部署自己的（无费率限制）

想要无限制的请求？ 在几分钟内部署自己的实例：


一键部署

git clone https://github.com/learnwithcc/directus-marketplace-search-mcp.git
cd directus-marketplace-search-mcp
chmod +x deploy/deploy.sh
./deploy/deploy.sh

部署脚本将：

1. ✅ 设置Cloudflare身份验证
2. ✅ 创建必要的云资源
3. ✅ 部署您的无限实例
4. ✅ 提供您的自定义服务器URL

部署后

您的实例将具有：

• 🚫 零利率限制 -无限制请求
• 🌍 全球边缘部署 -全球亚秒级响应
• 💰 可能免费托管 -Cloudflare慷慨的免费套餐覆盖了大部分使用量
• 🔒 您自己的数据 -完全控制和隐私

更新您的Claude桌面配置 使用新服务器：

{
  "mcpServers": {
    "directus-marketplace": {
      "command": "npx",
      "args": [
        "mcp-remote", 
        "https://your-worker-name.your-subdomain.workers.dev/mcp"
      ]
    }
  }
}

自助主机的成本估算

大多数用户停留在Cloudflare的免费等级内：

• 🆓 自由：每月高达1000万个请求+300万CPU毫秒/月
• 💵 已支付：仅当您超过免费限额时，最低每月5美元

实际使用示例：

• 小团队（10名用户）： 自由
• 中型团队（100名用户）： 自由
• 大型团队（1000+用户）：~5-15美元/月

查看详细的成本分析→

______________________________________________________________________

🛠️ 可用工具和功能

该服务器提供三种AI友好的搜索工具：

search_extensions

查找具有智能过滤和流行度指标的Directus扩展。

示例：“搜索图表扩展名”

I found 5 Directus extensions for "charts"!

**directus-extension-tradingview-panel**
A directus panel that show tradingview charts.

**directus-extension-display-link** (Very popular!)
Display URLs, phone numbers, and emails with a link button in Directus

get_extension_details

获取有关特定扩展的全面信息。

get_extension_categories

使用有用的描述探索所有可用的扩展类型。

扩展类别：

• 接口 -自定义字段输入组件
• 显示 -自定义字段显示组件
• 布局 -集合视图布局
• 面板 -仪表板小部件
• 模块 -整页应用程序部分
• 钩子 -服务器端事件处理程序
• 端点 -自定义API路由
• 运营 -流量操作节点
• 主题 -自定义样式和主题

______________________________________________________________________

📊 使用情况监控

随时检查您的使用情况：

• 个人统计数据： https://directus-marketplace-search-mcp.focuslab.workers.dev/usage
• 服务器分析： https://directus-marketplace-search-mcp.focuslab.workers.dev/admin/stats

速率限制标题 包含在所有回复中：

• X-RateLimit-Limit：您当前的限额
• X-RateLimit-Remaining：剩余请求
• X-RateLimit-Reset：当限制重置时

______________________________________________________________________

🆘 支持与帮助

常见问题

❓ “我在Claude Desktop中看不到工具”

• 添加配置后重新启动Claude Desktop
• 检查你的 claude_desktop_config.json 语法
• 直接尝试NPX命令： npx directus-marketplace-mcp

❓ “超出费率限制”

• 您已达到公共服务器上的100/小时或500/天的限制
• 部署您自己的无限实例（需要5分钟）
• 或者等待速率限制重置

❓ “未找到结果”

• 尝试使用更广泛的搜索词，如“界面”或“显示”
• 使用类别工具检查扩展类别
• 某些扩展可能没有正确标记

获得帮助

• 🐛 问题:
• 💬 讨论:
• 📚 MCP文件: 模型上下文协议
• 🏥 服务器运行状况: 健康检查

______________________________________________________________________

🔧 面向开发人员：技术文档

特性

• 🚀 边缘性能：部署在Cloudflare Workers全球网络上
• 🔍 综合搜索：按名称、描述、关键字搜索Directus扩展
• 📦 扩展类别：按界面、显示、布局、面板、模块、挂钩、端点、操作、主题过滤
• ⚡ 智能缓存：工人KV缓存，响应时间低于秒
• 🛡️ 安全第一：输入验证、净化和速率限制
• 🌐 协议协商：支持2024-11-05和2025-06-18 MCP版本
• 💬 对话结果：对自然交互的人工智能友好响应
• 📊 实时数据：与npm注册表直接集成以获得最新结果
• 🖥️ 通用兼容性：适用于Claude Desktop、web客户端和自定义MCP实现
• 🚦 智能速率限制：升级消息可配置限制
• 📈 使用情况监控：实时分析和成本估算

API终点

部署时，服务器会公开这些HTTP端点：

• /mcp：具有自动版本协商功能的MCP协议端点
• /health：健康检查端点
• /usage：个人使用统计和费率限制信息
• /admin/stats：服务器范围的分析和成本估算
• /：服务器信息、支持的协议版本和可用工具

地方发展

1. 克隆存储库:

   git clone https://github.com/learnwithcc/directus-marketplace-search-mcp.git
   cd directus-marketplace-search-mcp

1. 安装依赖项:

   npm install

1. 启动开发服务器:

   npm run dev

1. 运行类型检查:

   npm run type-check

1. 跑linting:

   npm run lint

测试

# Run tests
npm test

# Run tests in CI mode
npm run test:run

项目结构

directus-marketplace-search-mcp/
├── src/
│   ├── index.ts              # Main worker entry point
│   ├── mcp-simple.ts         # MCP server with protocol negotiation
│   ├── services/
│   │   ├── directus.ts       # npm registry API integration
│   │   ├── cache.ts          # Workers KV caching
│   │   ├── rate-limiter.ts   # IP-based rate limiting
│   │   └── monitoring.ts     # Usage analytics and monitoring
│   ├── types/
│   │   ├── worker.ts         # Cloudflare Worker types
│   │   └── directus.ts       # Extension and search types
│   └── utils/
│       └── validation.ts     # Input validation and sanitization
├── deploy/                   # One-click deployment resources
├── npm-package/             # NPX package for easy distribution
├── .github/workflows/
│   └── deploy.yml           # CI/CD pipeline
└── wrangler.toml            # Cloudflare Workers config

速率限制配置

用于您自己的部署，速率限制是完全可配置的，也可以完全禁用。

取消费率限制 在您的部署中：

1. 评论率限制 在……里面 src/mcp-simple.ts:

// Rate limiting (skip for non-functional requests)
// if (request.method !== 'OPTIONS') {
//   const clientIP = this.rateLimiter.getClientIP(request);
//   const rateLimitResult = await this.rateLimiter.checkRateLimit(clientIP);
//   // ... rate limiting logic
// }

1. 或调整限制 在……里面 src/services/rate-limiter.ts:

private static readonly REQUESTS_PER_HOUR = 10000;  // Increase limits
private static readonly REQUESTS_PER_DAY = 100000;   // Or set very high

1. 或完全禁用 通过设定限制 Infinity:

private static readonly REQUESTS_PER_HOUR = Infinity;
private static readonly REQUESTS_PER_DAY = Infinity;

公共服务器有速率限制，以防止滥用和管理成本。您自己的部署可以有您选择的任何限制，包括根本没有限制。

部署

自动部署（推荐）

该存储库包括用于自动部署的GitHub Actions：

1. 设置存储库机密:

- CLOUDFLARE_API_TOKEN：您的Cloudflare API代币 - CLOUDFLARE_ACCOUNT_ID：您的Cloudflare帐户ID

1. 推送到主分支：自动进行部署

手动部署

# Full deployment with checks
npm run deploy

# Quick deployment (skip checks)
npm run deploy:quick

配置

环境变量

在Cloudflare Workers仪表板中或通过Wrangler配置这些：

• ENVIRONMENT：部署环境(development, staging, production)
• DIRECTUS_API_TOKEN：（可选）用于私人市场访问

KV命名空间

部署脚本会自动创建用于缓存的KV命名空间。您也可以手动创建它：

wrangler kv:namespace create "CACHE"

演出

• 全局边缘：部署在全球300多个Cloudflare数据中心
• 亚秒级响应：Workers KV智能缓存
• 并发请求：处理数千个同时进行的请求
• 零冷启动：Cloudflare Workers架构
• 协议协商：自动选择版本以实现最佳兼容性

安全

• 输入消毒：所有用户输入都经过验证和消毒
• 速率限制：可配置的防滥用保护
• CORS支持：通过智能源处理实现安全的跨源资源共享
• 代码中没有秘密：基于环境的配置
• 协议安全性：通过会话管理支持安全的MCP传输

API集成

服务器与npm注册表API集成以访问Directus扩展：

• 数据源: https://registry.npmjs.org/-/v1/search
• 过滤：Directus特定包的自动筛选
• 缓存：搜索结果缓存5分钟，套餐详情缓存1小时
• 速率限制：具有内置节流功能的API使用尊重

贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/amazing-feature
3. 提交更改： git commit -m 'Add amazing feature'
4. 推送到分支： git push origin feature/amazing-feature
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关项目

• Directus -开源数据平台
• 模型上下文协议 -人工智能上下文集成协议
• Cloudflare员工 -无服务器计算平台

______________________________________________________________________

内置于❤️ Directus社区

🤖 *由...驱动 克劳德代码*

Live服务器

🌐 公共实例: https://directus-marketplace-search-mcp.focuslab.workers.dev/mcp

已准备好与Claude Desktop、MCP客户端和自定义集成一起使用！