跨mcp服务器
索引的MCP（模型上下文协议）服务器 跨协议文档 并为构建跨链应用提供AI驱动的工具。
连接到 托管服务器位于 mcp.across.to/mcp 或者在本地运行它，然后与 克劳德桌面版, 克劳德代码, 光标, 法典, 帆板运动，或任何兼容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 | 强制重新抓取以获取最新文档 |
托管服务器（无需安装）
此服务器的生产实例托管在 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 upFly.io：
fly launch
fly deployAWS/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它是如何工作的：
- 启动时，从以下位置加载缓存的文档
~/.across-mcp/cache.json - 如果缓存已过时（>24小时）或丢失，则在后台抓取docs.across.to
- 在所有文档中构建TF-IDF搜索索引
- 通过MCP协议公开7个工具
- 每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.jsMCP检查器为您提供了一个UI，用于交互式测试每个工具。
______________________________________________________________________
涵盖的文档
服务器将docs.across.to中的以下部分编入索引：
- 概述 --什么是跨协议，介绍
- 开发人员快速入门 --跨链交换集成，ERC-7683，嵌入式操作
- 概念 --跨链意图，意图生命周期
- API 参考 -所有REST API端点（费用、路线、存款、掉期）
- SDK参考 --@跨协议/应用sdk使用
- 支持的链 --22+主网链，8个测试网链
- 令牌地址 --支持令牌的合约地址
- 中继器 --运行和提名中继
- 资源 --支持链接、审计、漏洞赏金
______________________________________________________________________
许可证
麻省理工学院