RUAGENTIC Directory

RUAGENTIC Directory

RUAGENTIC 是专为 Agentic AI MCP 服务、客户端和工具打造的官方 Agentic 目录。这是一个独立目录，与官方 Model Context Protocol 注册表相互独立。

该目录位于 **https://ruagentic.com**。免费的文件规范、生成器、审计工具和 CLI 位于 **https://ruagentic.org**，并存放在单独的 sam1siam/agentic 仓库中。

功能

• 响应式发现页面、分类、集合、详细项目页面、并排比较，以及支持键盘访问的 Ctrl/Cmd+K 搜索面板。
• GitHub 登录、无密码电子邮件链接、密码账户与恢复功能、已保存工具和目录列表控制面板。
• 四步提交流程，可从公开网站、代码仓库、文档、OpenAPI、Agentic 配置文件和 README 自动填充 URL。建议会显示来源并保留手动修改。
• 一次性支付 US$49.99 的 Stripe 收录费用；或者通过服务端验证的 Agentic JSON、TXT 和 README 检查后免费发布。
• 绑定修订版本的发布、不可变快照、可靠的付款处理、退款处理，以及事务性确认邮件发件箱。
• 公开发现 API、只读 MCP 服务，以及在支持 WebMCP 的浏览器中筛选目录。
• 标注来源的注册表和编辑精选条目。导入并不表示所有权、提交行为或采用 Agentic。

本地运行

使用 Node 24。将 .env.example 复制为 .env.local，并配置一个独立的目录 Supabase 项目和提供商测试凭据。要使用本地表单，请设置 APP_URL=http://localhost:3207，并在测试 Supabase 项目中允许该回调来源。

npm ci
npm run dev

如果未设置账户变量，公开目录页面将使用随代码提供的源数据，账户表单则会提示配置尚未完成。生产环境必须先配置所有提供商，才能接受提交。

数据库

按顺序将 supabase/migrations/ 中的文件应用到目录项目。第一个文件会创建表、RLS 策略、不可变修订版本，以及事务性发布/付款函数；后续文件会替换函数或约束，可安全地在现有基础上应用。浏览器角色无法发布内容或更改付款/验证状态。

导入带有来源标注的目录一次：

node --env-file=.env.local scripts/seed.ts

种子数据会保留现有行。data/catalog.json 保留来源 URL 和集合日期；注册表元数据许可不授予第三方软件或商标的权利。

部署

请参阅部署与运维。Vercel 项目：ruagentic-directory。GitHub 仓库：sam1siam/ruagentic-directory。切勿将此检出版本部署到该规范的 ruagentic Vercel 项目中。

npm test
npm run typecheck
npm run build

接口

• GET /api/v1/listings — 公开搜索，支持 q、kind、category、limit 和 offset。
• GET /api/v1/listings/{slug} — 公开目录条目详情。
• /mcp — 提供 search_directory 和 get_listing 的 Streamable HTTP MCP；只读，无需密钥。
• /agentic.json、/agentic.txt、/llms.txt、/openapi.json — 已发布的机器可读文档。

每日发现机制记录在 docs/DISCOVERY.md 中。它会从公开来源发现新的 MCP 服务、MCP 客户端和 AI Agent，排除历史条目，并将拥有独立网站的条目作为导入条目发布，供其所有者认领。

Agentic 发布

• Agentic JSON 配置文件
• Agentic TXT 索引
• Agentic 规范和免费工具
• RUAGENTIC 目录

Agentic 是一种开放的文件规范，用于描述网站、API 和 Agent 连接，并提供用于生成、验证、审计和操作结果验证的规范与工具。RUAGENTIC 是面向 Agentic AI MCP 服务和工具的官方 Agentic 目录。

安全与更正

请勿提交私人令牌或包含凭据的 URL。目录内容属于不可信的项目信息；文件检查不构成安全或所有权认证。请使用条目上的“Report”选项提交更正。对于私人账户或付款信息，请使用网站上公布的支持联系方式，而非公开的 GitHub 问题。