MCP Server Across

跨mcp服务器

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

连接到 托管服务器位于 mcp.across.to/mcp 或者在本地运行它，然后与 克劳德桌面版, 克劳德代码, 光标, 法典, 帆板运动，或任何兼容MCP的客户端，以便即时访问Across Protocol文档、API引用、代码示例和实时桥接费用查询-所有这些都无需离开编辑器。

它做什么

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

托管服务器（无需安装）

此服务器的生产实例托管在 https://mcp.across.to/mcp 使用流式HTTP传输。您可以直接连接任何兼容MCP的客户端，无需在本地进行克隆、构建或运行任何操作。

克劳德桌面版

编辑您的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": {
      "url": "https://mcp.across.to/mcp"
    }
  }
}

克劳德代码（CLI）

claude mcp add --transport http across-docs https://mcp.across.to/mcp

或添加到 .mcp.json:

{
  "mcpServers": {
    "across-docs": {
      "url": "https://mcp.across.to/mcp"
    }
  }
}

光标

创建或编辑 .cursor/mcp.json 在项目根目录（或全局Cursor MCP配置）中：

{
  "mcpServers": {
    "across-docs": {
      "url": "https://mcp.across.to/mcp"
    }
  }
}

VS代码（副本）

添加 .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "across-docs": {
        "url": "https://mcp.across.to/mcp"
      }
    }
  }
}

Codex（OpenAI CLI）

{
  "mcpServers": {
    "across-docs": {
      "url": "https://mcp.across.to/mcp"
    }
  }
}

帆板运动

添加 ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "across-docs": {
      "url": "https://mcp.across.to/mcp"
    }
  }
}

______________________________________________________________________

快速入门（自托管）

先决条件

• 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个测试网链
• 令牌地址 --支持令牌的合约地址
• 中继器 --运行和提名中继
• 资源 --支持链接、审计、漏洞赏金

______________________________________________________________________

许可证

麻省理工学院