Titan Frameworks (LangChain, LlamaIndex, Ollama, XRPL)

Titan Frameworks

付费 MCP，可根据最新 API 审查并重写 LangChain、LlamaIndex、Ollama 和 XRPL 代码，还提供可运行示例、导入查询，以及绝不会提交交易的交易骨架。仍包含实时文档。

实时 Streamable HTTP： https://titan-frameworks-production.up.railway.app/mcp
通过 x402 付费：0.001 USDC（Base），或 1000 drops XRP / 0.001 RLUSD（XRPL 主网）。

Agent 发现：llms.txt · Smithery smithery.yaml · MCP Registry server.json

工具

工具	用途
review_framework_code	在代码片段导致崩溃前检查其中的失效 API。返回代码块，不会执行
rewrite_framework_code	应用保守的目录重写；剩余列表会列出不安全的调用点
diagnose_framework_error	堆栈跟踪 → 已弃用 API → 精确修复方案。仅在遇到错误时使用
resolve_symbol	查询某个 API 名称对应的软件包、安装方式、导入语句和调用形式
fetch_working_example	获取针对某个目标（Agent、RAG、支付等）的完整可运行文件
fetch_latest_syntax	获取某个主题的可用代码片段和迁移说明。编写片段时使用
search_ai_framework_docs	搜索本地 Markdown 中的关键词。适用于概念或符号，不适用于堆栈跟踪
draft_xrpl_intent_tx	类型化 XRPL 交易骨架。绝不会提交交易或转移资金
list_supported_frameworks	列出框架 ID、别名和目录主题（免费的 tools/call）
list_known_deprecations	获取某个框架或全部四个框架的完整弃用目录

提示词：migrate_framework_code、diagnose_stack_trace、start_from_example。

按需选择：即将运行的源码 → review_framework_code；需要修补后的文件 → rewrite_framework_code；堆栈跟踪 → diagnose_framework_error；已知符号 → resolve_symbol；需要完整文件 → fetch_working_example；主题代码片段 → fetch_latest_syntax；概念 → search_ai_framework_docs；XRPL 交易 → draft_xrpl_intent_tx；查询支持的框架 → list_supported_frameworks；查询所有弃用项 → list_known_deprecations。

连接客户端

{
  "mcpServers": {
    "titan-frameworks": {
      "url": "https://titan-frameworks-production.up.railway.app/mcp"
    }
  }
}

支持 x402 的客户端会在收到 402 后发送 PAYMENT-SIGNATURE / X-PAYMENT。本地 stdio（titan-frameworks / npm run dev）不会收费。

要从 Cursor 向生产环境付款，请在 MCP 设置中启用 titan-frameworks-paid（运行 scripts/cursor-x402-proxy.ts，从 .env 中的 EVM_PRIVATE_KEY 对 Base USDC 交易签名，X402_PROXY_MAX_CALLS 上限默认为 25）。运行 npx tsx scripts/cursor-x402-proxy.ts --check 检查代理。

HTTP 端点

路径	说明
GET /health	存活状态 + 索引统计
GET /llms.txt	Agent 发现
GET /tools	工具列表 + 实时定价
GET /.well-known/x402	x402scan 资源索引
GET /.well-known/x402.json	完整支付要求 + bazaar 元数据
GET /.well-known/mcp/server-card.json	Smithery 静态卡片
ALL /mcp	Streamable HTTP MCP。握手、tools/list、list_supported_frameworks 免费；其他 tools/call 需付费

本地运行（stdio）

cd titan-frameworks
npm install
npm run dev

项目配置位于 .cursor/mcp.json。种子文档随 src/data/seed-fallback.json 一同提供。

npm run index-docs

当实时索引超过 24 小时时，生产环境会自动重新索引。仍可通过 /admin 立即触发抓取。

HTTP 模式（Vercel / Railway）

npm run dev:http
# POST http://127.0.0.1:3333/mcp

npm run build
npm start

Railway 使用 railway.toml（npm run start）。Vercel 会将请求重写到 api/index.ts。

x402 小额支付

生产环境计费已启用。 在 POST https://titan-frameworks-production.up.railway.app/mcp 上未付款调用 tools/call 会返回 402，但 list_supported_frameworks 除外，该工具免费。initialize、ping 和 tools/list 均免费，方便目录对连接器进行健康检查。

支付通道	价格	网络	Facilitator
USDC	$0.001	Base (eip155:8453)	PayAI
XRP	1000 drops（0.001 XRP）	XRPL 主网 (xrpl:0)	T54
RLUSD	0.001	XRPL 主网 (xrpl:0)	T54

直接转账至钱包不属于 x402 付款凭证。客户端会携带 PAYMENT-SIGNATURE / X-PAYMENT 重试 /mcp。本地 stdio（npm run dev）不收费。

要在本地复现计费门控：设置 X402_ENABLED=true（模拟模式），并设置 X402_USDC_LIVE=true / X402_XRPL_LIVE=true 以进行实时验证和结算。

密码保护的管理后台

生产环境仪表板：https://titan-frameworks-production.up.railway.app/admin

这不是公开的统计信息页面。登录时会校验密码是否与 ADMIN_SECRET_KEY 匹配。未经身份验证的 /api/admin/* 调用会返回 401。旧的公开路由 /admin/api/stats 已移除（404）。

布局

src/app/           Next.js admin UI + /api/admin routes
src/components/    Admin dashboard React components
src/tools/         MCP tool handlers
src/mcp/tools.ts   tool registration (includes xrpl)
src/indexer/       xrpl.js crawl targets
src/services/      search, indexer, store, x402, earnings, discovery
src/data/          JSON index, syntax catalog, known errors, symbol map, examples, XRPL intents
src/types/         Zod schemas + TS types
scripts/           index-docs, x402-smoke
server.json        MCP Registry remote listing
smithery.yaml      Smithery remote listing
glama.json         Glama maintainer claim