MCP 配置指南

本指南帮助你快速配置 ChainStream MCP Server。

前提条件

要求	详情	如何获取
ChainStream 账号	已注册账号	注册
API Key	用于认证的 `X-API-KEY`	Dashboard → 应用 → 创建应用
AI 客户端	Claude Desktop / Cursor / 自定义客户端	已安装

MCP 端点

ChainStream 提供托管的 MCP Server，无需本地安装 — 直接连接：

https://mcp.chainstream.io/mcp

配置步骤

获取 API Key

登录 ChainStream Dashboard
进入 Applications
点击 Create New App 并复制你的 API Key

配置 AI 客户端

Claude Desktop
Cursor IDE
自定义客户端

配置文件路径：

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

方式 A — 云端端点（推荐）：

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

方式 B — 本地 npm 包（stdio）：

{
  "mcpServers": {
    "chainstream": {
      "command": "npx",
      "args": ["@chainstream-io/mcp"],
      "env": {
        "CHAINSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

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

配置文件路径：.cursor/mcp.json（项目级）或 Cursor 设置 → Features → MCP Servers方式 A — 云端端点：

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

方式 B — 本地 npm 包（stdio）：

{
  "mcpServers": {
    "chainstream": {
      "command": "npx",
      "args": ["@chainstream-io/mcp"],
      "env": {
        "CHAINSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

通过 HTTP 连接云端端点：

端点	URL	方法
MCP 端点	`https://mcp.chainstream.io/mcp`	POST

认证：通过 X-API-KEY 请求头传递 API Key。示例代码：

import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.chainstream.io/mcp'),
  {
    requestInit: {
      headers: {
        'X-API-KEY': process.env.CHAINSTREAM_API_KEY
      }
    }
  }
);

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 客户端中输入以下测试问题：

Solana 上的 SOL 代币是什么？安全吗？

预期结果

如果配置成功，AI 应该：

调用 tokens_search 查找 SOL 代币
调用 tokens_analyze 获取安全和持有者数据
返回自然语言摘要

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

常见问题

认证失败

可能原因：

API Key 输入错误
- 检查是否有多余空格
- 确认完整复制
API Key 已撤销或过期
- 在 Dashboard 检查 Key 状态
- 如需要可创建新 Key
请求头名称错误
- 云端端点：使用 X-API-KEY 请求头
- npm 包：使用 CHAINSTREAM_API_KEY 环境变量

解决方案：

在 Dashboard → Applications 中验证 Key
直接测试：curl -H "X-API-KEY: your_key" https://api.chainstream.io/v2/blockchain

连接失败

可能原因：

网络问题
- 检查网络连接
- 确认可以访问 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 验证工具检查
客户端未重启
- 完全退出后重启

解决方案：

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

工具调用失败：配额超限

可能原因：

套餐配额已耗尽
请求频率过高，触发限流

解决方案：

在 Dashboard 查看配额使用情况
升级套餐获取更多配额

数据返回延迟或超时

可能原因：

网络延迟
查询数据量过大

解决方案：

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

下一步

工具目录

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

AI Agent 教程

构建 AI 交易助手

入门指南

数据概念

AI 基础设施

CLI

安全与合规

集成

资源

法律与政策

前提条件

MCP 端点

配置步骤

验证配置

测试命令

预期结果

常见问题

下一步

工具目录

AI Agent 教程

入门指南

数据概念

AI 基础设施

CLI

安全与合规

集成

资源

法律与政策

​前提条件

​MCP 端点

​配置步骤

​验证配置

​测试命令

​预期结果

​常见问题

​下一步

工具目录

AI Agent 教程

前提条件

MCP 端点

配置步骤

验证配置

测试命令

预期结果

常见问题

下一步