AI导哈

跨链文档索引服务器

一个索引Across Protocol文档并提供AI支持工具以构建跨链应用的MCP服务器。

  • by KanishkKhurana
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 KanishkKhurana/mcp-server-across

使用说明

跨mcp服务器

索引的MCP（模型上下文协议）服务器 跨协议文档 并为构建跨链应用提供AI驱动的工具。

将此服务器连接到 克劳德桌面版, 克劳德代码, 光标, 法典, 帆板运动，或任何兼容MCP的客户端，以便即时访问Across Protocol文档、API引用、代码示例和实时桥接费用查询-所有这些都无需离开编辑器。

它做什么

此服务器抓取并索引整个跨协议文档，然后通过7个MCP工具公开它：

工具 说明
search_across_docs 在所有文档中进行全文搜索
get_page 获取任何文档页面的完整内容
get_api_reference 浏览REST API端点及其详细信息
get_supported_chains 列出所有支持的主网/测试网链及其链ID
get_bridge_fees 生活 查询Across API以获取实时桥梁费用报价
get_code_examples 按主题获取SDK和集成代码示例
recrawl_docs 强制重新抓取以获取最新文档

快速开始

先决条件

  • Node.js>=18
  • npm

安装和构建

git clone https://github.com/your-username/mcp-server-across.git
cd mcp-server-across
npm install
npm run build

服务器第一次运行时，它将抓取docs.across.to并将所有内容缓存到本地 ~/.across-mcp/cache.json。随后立即开始从缓存加载，并每24小时在后台重新爬网。

客户端设置

克劳德桌面版

编辑您的Claude Desktop配置文件：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "across-docs": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-across/dist/index.js"]
    }
  }
}

重新启动克劳德桌面。您将在工具选择器中看到“跨越”工具。

克劳德代码（CLI）

添加到您的项目 .mcp.json 或全局克劳德代码设置：

{
  "mcpServers": {
    "across-docs": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-across/dist/index.js"]
    }
  }
}

或者直接运行：

claude mcp add across-docs node /absolute/path/to/mcp-server-across/dist/index.js

光标

创建或编辑 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "across-docs": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-across/dist/index.js"]
    }
  }
}

重新启动游标。这些工具将在Cursor的AI聊天中提供。

VS代码（副本）

添加到您的VS代码设置(.vscode/settings.json):

{
  "mcp": {
    "servers": {
      "across-docs": {
        "command": "node",
        "args": ["/absolute/path/to/mcp-server-across/dist/index.js"]
      }
    }
  }
}

Codex（OpenAI CLI）

添加到Codex MCP配置中：

{
  "mcpServers": {
    "across-docs": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-across/dist/index.js"]
    }
  }
}

帆板运动

添加 ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "across-docs": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-across/dist/index.js"]
    }
  }
}

用法示例

连接后，您可以向您的AI助手询问以下问题：

  • “在Across文档中搜索如何进行跨链交换”
  • “显示建议费用的Across API端点”
  • “Across Protocol支持哪些链？”
  • “获取使用Across SDK的代码示例”
  • “从以太坊向Arbitrum发送USDC的过桥费是多少？”
  • “我如何运行Across中继器？”
  • “显示ERC-7683意图的完整页面”

人工智能将使用MCP工具从索引文档中获取准确、最新的信息。

部署

本地（建议个人使用）

只需构建MCP客户端并将其指向 dist/index.js --就是这样。服务器作为本地stdio进程运行。

npm run build
# Configure your client as shown above

码头工人

# Build the image
docker build -t mcp-server-across .

# Run (stdio mode — for use with Docker-aware MCP clients)
docker run -i mcp-server-across

对于使用Docker的Claude Desktop：

{
  "mcpServers": {
    "across-docs": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp-server-across"]
    }
  }
}

要在容器重启时持久化缓存，请执行以下操作：

docker run -i -v across-mcp-cache:/root/.across-mcp mcp-server-across

云部署（铁路/Fly.io/AWS）

对于远程部署，服务器使用stdio传输，该传输与云托管的MCP代理配合使用。您可以部署到任何云提供商：

铁路：

# Install Railway CLI
npm i -g @railway/cli

# Deploy
railway init
railway up

Fly.io：

fly launch
fly deploy

AWS/GCP/Azure： 将Docker镜像部署到您选择的容器服务（ECS、Cloud Run、container Apps）。

注意：对于远程MCP服务器，您需要一个MCP代理层或使用Streamable HTTP传输。目前，大多数MCP客户端最支持stdio（本地）传输。

npm全局安装

您还可以全局安装它：

npm install -g .
# Then use:
mcp-server-across

建筑

src/
├── index.ts          # Entry point — stdio transport + background crawling
├── server.ts         # MCP server with all 7 tool registrations
├── crawler.ts        # Fetches & parses docs.across.to pages (cheerio)
├── store.ts          # In-memory doc store + JSON disk cache
├── search.ts         # TF-IDF text search engine
└── data/
    └── known-urls.ts # All known doc URLs + chain data + API endpoints

它是如何工作的：

  1. 启动时，从以下位置加载缓存的文档 ~/.across-mcp/cache.json
  2. 如果缓存已过时（>24小时）或丢失，则在后台抓取docs.across.to
  3. 在所有文档中构建TF-IDF搜索索引
  4. 通过MCP协议公开7个工具
  5. 每24小时重新抓取一次以保持最新状态

相关性很小：

  • @modelcontextprotocol/sdk --MCP协议
  • cheerio --HTML解析
  • zod --架构验证

发展

# Watch mode for development
npm run dev

# Build
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

MCP检查器为您提供了一个UI，用于交互式测试每个工具。

涵盖的文档

服务器将docs.across.to中的以下部分编入索引：

  • 概述 --什么是跨协议，介绍
  • 开发人员快速入门 --跨链交换集成，ERC-7683，嵌入式操作
  • 概念 --跨链意图，意图生命周期
  • API 参考 -所有REST API端点（费用、路线、存款、掉期）
  • SDK参考 --@跨协议/应用sdk使用
  • 支持的链 --22+主网链，8个测试网链
  • 令牌地址 --支持令牌的合约地址
  • 中继器 --运行和提名中继
  • 资源 --支持链接、审计、漏洞赏金

许可证

麻省理工学院

相关 MCP