MCP 配置指南

本指南帮助您快速完成 ChainStream MCP Server 的配置。

前置条件

在开始之前，请确保您已准备：

条件	要求	检查方式
ChainStream 账户	已注册账户	登录控制台确认
Access Token	有效的访问令牌	控制台 → Apps → 生成 Token
AI 客户端	Claude Desktop / Cursor / 自定义客户端	已安装

MCP 端点

ChainStream 提供托管的 MCP Server，无需本地安装，直接通过以下端点访问：

https://mcp.chainstream.io/mcp

配置步骤

获取 Access Token

登录 ChainStream 控制台
导航至 Apps 页面
创建 App 获取 Client ID 和 Client Secret
使用凭据生成 Access Token（参考认证文档）

Access Token 有效期为 24 小时，建议在应用中实现自动刷新机制。

配置 AI 客户端

Claude Desktop
Cursor IDE
自定义客户端

配置文件路径：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

配置内容：

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "Authorization": "Bearer your_access_token"
      }
    }
  }
}

如果文件不存在，请手动创建。如果已有其他 MCP Server 配置，在 mcpServers 对象中添加 chainstream 配置即可。

配置文件路径：~/.cursor/mcp.json配置内容：

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "Authorization": "Bearer your_access_token"
      }
    }
  }
}

如果您使用自定义 MCP 客户端，通过 HTTP+SSE 协议连接：端点信息：

端点	地址
MCP 端点	`https://mcp.chainstream.io/mcp`
SSE 端点	`https://mcp.chainstream.io/sse`
消息端点	`https://mcp.chainstream.io/messages`

认证方式：在请求头中添加 Authorization：

Authorization: Bearer your_access_token

示例代码：

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';

const transport = new SSEClientTransport(
  new URL('https://mcp.chainstream.io/sse'),
  {
    requestInit: {
      headers: {
        'Authorization': `Bearer ${process.env.CHAINSTREAM_ACCESS_TOKEN}`
      }
    }
  }
);

const client = new Client({
  name: 'my-client',
  version: '1.0.0'
});

await client.connect(transport);

// 列出可用工具
const { tools } = await client.listTools();
console.log('Available tools:', tools.map(t => t.name));

重启客户端

配置完成后，完全退出并重新启动 AI 客户端，使配置生效。

Claude Desktop：完全退出（不是最小化），重新打开
Cursor：重启 IDE

验证配置

测试命令

在 AI 客户端中输入以下测试问题：

查询 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 在以太坊上的 Token 余额

预期结果

如果配置成功，AI 应该能够：

识别这是一个余额查询请求
调用 get_token_balance 工具
返回该地址的 Token 余额列表

成功示例：

该地址（Vitalik.eth）在以太坊上的持仓如下：

| Token | 余额 | 价值 (USD) |
|-------|------|-----------|
| ETH   | 1,234.56 | $2,469,120 |
| USDC  | 50,000 | $50,000 |
| ...   | ... | ... |

总价值：约 $2,500,000

如果 AI 没有调用工具或返回错误，请参考下方常见问题排查。

常见问题

认证失败

可能原因：

Access Token 输入错误
- 检查是否有多余空格
- 确认复制完整
Access Token 已过期
- Token 有效期为 24 小时
- 需要重新生成
Token 格式错误
- 确认是完整的 JWT 格式
- 确认添加了 Bearer 前缀

解决方案：

重新生成 Access Token
检查 Token 是否过期
确认 Authorization header 格式正确

连接失败

可能原因：

网络问题
- 检查网络连接
- 确认能访问 https://mcp.chainstream.io
配置格式错误
- 检查 JSON 格式是否正确
- 确认 URL 拼写正确

解决方案：

# 测试端点连通性
curl -I https://mcp.chainstream.io/mcp

配置文件不生效

可能原因：

配置文件路径错误
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
JSON 格式错误
- 使用 JSON 校验工具检查
客户端未重启
- 完全退出并重新启动

解决方案：

# macOS 验证配置文件
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

工具调用失败：配额不足

可能原因：

套餐配额已用完
请求频率过高触发限流

解决方案：

登录控制台查看配额使用情况
升级套餐获取更多配额

数据返回延迟或超时

可能原因：

网络延迟
查询数据量过大
服务端负载高

解决方案：

检查网络连接
减少单次查询数据量
稍后重试

下一步

工具目录

查看所有可用工具和使用示例

AI Agent 教程

构建 AI 交易助理

入门指南

数据概念

安全与合规

AI 基础设施

资源

法律与政策

前置条件

MCP 端点

配置步骤

验证配置

测试命令

预期结果

常见问题

下一步

工具目录

AI Agent 教程

入门指南

数据概念

安全与合规

AI 基础设施

资源

法律与政策

​前置条件

​MCP 端点

​配置步骤

​验证配置

​测试命令

​预期结果

​常见问题

​下一步

工具目录

AI Agent 教程

前置条件

MCP 端点

配置步骤

验证配置

测试命令

预期结果

常见问题

下一步