> ## Documentation Index > Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt > Use this file to discover all available pages before exploring further. # MCP 介绍 > 了解 Model Context Protocol 和 ChainStream MCP Server ## MCP 是什么 **MCP (Model Context Protocol)** 是由 Anthropic 提出的开放协议，旨在标准化 AI 应用与外部数据源的连接方式。 简单来说，MCP 让 AI 能够： * 发现可用的工具和数据源 * 调用外部工具执行操作 * 理解返回的结构化数据 ### 传统方式 vs MCP | 方式 | 流程 | | ---------- | ---------------------------------------- | | **传统方式** | 用户 → 编写代码 → 调用 API → 解析数据 → 输入 AI → 获得回答 | | **MCP 方式** | 用户 → 自然语言提问 → AI 自动调用工具 → 获得回答 | ### 核心概念 | 概念 | 说明 | | -------------- | ------------------------------------ | | **MCP Server** | 提供工具和数据的服务端，如 ChainStream MCP Server | | **MCP Client** | 使用工具的客户端，如 Claude Desktop、Cursor | | **Tools** | 可被 AI 调用的功能，如查询余额、分析钱包 | | **Resources** | 可被 AI 访问的数据资源 | *** ## 为什么 MCP 很重要 ### AI Agent 需要"手和眼" AI 大模型拥有强大的推理能力，但它们： * ❌ 无法直接访问实时数据 * ❌ 无法执行外部操作 * ❌ 知识存在截止日期 MCP 解决了这个问题，让 AI 能够： * ✅ 实时获取链上数据 * ✅ 调用专业工具进行分析 * ✅ 与外部世界交互 **类比理解** MCP 之于 AI，就像： * **眼睛** → 让 AI 看到实时数据 * **手** → 让 AI 执行操作 * **工具** → 让 AI 使用专业能力 *** ## ChainStream MCP 能力 ChainStream MCP Server 将区块链数据和分析能力以 MCP 协议暴露给 AI 应用。 **MCP 端点**：`https://mcp.chainstream.io/mcp` ### 能力矩阵 ChainStream MCP Server 支持 API Reference 中所有的 REST API 和 WebSocket 订阅功能： | 功能 | 说明 | | ------------ | -------------- | | 代币搜索 | 按名称/符号搜索代币 | | 代币信息 | 获取代币基本信息和元数据 | | 代币价格 | 实时价格和历史价格 | | 代币统计 | 交易量、市值等统计数据 | | 持有者分析 | 持有者分布和 Top 持有者 | | K 线数据 | 各周期 OHLCV 数据 | | 市场数据 | 流动性、交易对信息 | | 安全检查 | 代币合约安全分析 | | 创建信息 | 代币创建者和时间 | | Mint/Burn 历史 | 代币铸造和销毁记录 | | 流动性快照 | 历史流动性数据 | | 功能 | 说明 | | ------ | --------- | | 余额查询 | 钱包代币余额 | | PnL 计算 | 盈亏分析 | | 钱包统计 | 交易次数、活跃度等 | | 余额更新历史 | 余额变化记录 | | 功能 | 说明 | | ----- | -------------- | | 交易历史 | 获取交易记录 | | 交易活动 | 实时交易活动 | | 顶级交易者 | Top Traders 排名 | | 功能 | 说明 | | ------ | ---------- | | 报价查询 | 获取交易报价 | | 路由计算 | 最优交易路径 | | 交换执行 | 构建交换交易 | | DEX 列表 | 支持的 DEX 信息 | | 功能 | 说明 | | ---- | ------------------ | | 热门代币 | 按时间段排名 | | 新代币 | 最新上线代币 | | 即将毕业 | Bonding Curve 接近毕业 | | 已毕业 | 已迁移到 DEX | | 订阅类型 | 说明 | | ------ | -------- | | 代币 K 线 | 实时 K 线更新 | | 代币统计 | 实时统计数据 | | 代币持有者 | 持有者变化 | | 新代币 | 新代币创建通知 | | 钱包余额 | 实时余额更新 | | 钱包交易 | 实时交易通知 | | 流动性池 | 池子余额变化 | ### 支持的区块链 | 链 | 标识 | 类型 | 状态 | | -------- | ----- | -- | -- | | Solana | `sol` | L1 | ✅ | | Ethereum | `eth` | L1 | ✅ | | BSC | `bsc` | L1 | ✅ | 在所有 MCP 工具参数中使用小写链标识符：`sol`、`eth`、`bsc`。 *** ## 支持的平台 ### Claude Desktop 官方支持的 MCP 客户端，提供最完整的功能支持。 | 特性 | 支持状态 | | ---- | ---- | | 工具调用 | ✅ | | 多轮对话 | ✅ | | 流式响应 | ✅ | ```json theme={null} // claude_desktop_config.json { "mcpServers": { "chainstream": { "url": "https://mcp.chainstream.io/mcp", "headers": { "X-API-KEY": "your-api-key" } } } } ``` ### Cursor IDE 开发者友好的 AI 编程助手，支持 MCP 集成。 | 特性 | 支持状态 | | ----- | ---- | | 工具调用 | ✅ | | 代码上下文 | ✅ | ```json theme={null} // .cursor/mcp.json { "mcpServers": { "chainstream": { "url": "https://mcp.chainstream.io/mcp", "headers": { "X-API-KEY": "your-api-key" } } } } ``` ### 自定义 Agent 任何遵循 MCP 协议的客户端都可以接入。 ```javascript theme={null} import { Client } from '@modelcontextprotocol/sdk/client/index.js'; import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.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-agent', version: '1.0.0' }); await client.connect(transport); // 列出可用工具 const { tools } = await client.listTools(); // 调用工具 const result = await client.callTool({ name: 'wallets_profile', arguments: { address: '0x...', chain: 'eth' } }); ``` *** ## 典型使用场景 ### 场景 1：AI 研究助手 **需求**：使用 AI 分析特定钱包的交易行为 分析地址 `0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045` 的交易风格 调用 `wallets_profile` 工具 基于分析，该地址（Vitalik）的特征如下： * 钱包年龄：超过 5 年 * 主要持仓：ETH、各类 ERC-20 Token * 交易风格：长期持有为主，偶有捐赠和项目支持 * 活跃协议：Uniswap、ENS、Gitcoin * 标签：核心开发者、公益捐赠者 ### 场景 2：Smart Money 追踪 **需求**：追踪 Smart Money 的大额交易 最近 24 小时有哪些 Smart Money 在买入 ARB？ 调用 `market_trending` 工具 过去 24 小时，以下 Smart Money 地址买入了 ARB： 1. `0xabc...123` (标签: whale, defi\_expert) * 买入数量：500,000 ARB * 买入金额：\$450,000 * 时间：2 小时前 2. `0xdef...456` (标签: institution) * 买入数量：200,000 ARB * 买入金额：\$180,000 * 时间：5 小时前 整体趋势：Smart Money 对 ARB 呈净买入状态 ### 场景 3：代币安全分析 **需求**：分析某代币的安全性 帮我检查这个代币 `0x...` 是否安全 调用 `tokens_analyze` 工具 该代币安全检查结果： | 检查项 | 结果 | | ----- | ---------------- | | 合约已验证 | ✅ | | 无恶意函数 | ✅ | | 流动性锁定 | ✅ | | 持有者分散 | ⚠️ Top 10 持有 45% | | 交易税 | 买入 1% / 卖出 1% | 风险等级：中等（注意持有者集中度） *** ## 技术架构 ```mermaid theme={null} sequenceDiagram participant User as 用户 participant AI as AI 客户端
(Claude / Cursor) participant MCP as ChainStream MCP
(17 工具) participant API as ChainStream API
(SOL / ETH / BSC) User->>AI: "这个代币安全吗？" AI->>AI: 选择 tokens_analyze 工具 AI->>MCP: tokens_analyze(chain, address) MCP->>API: GET /v2/token/{chain}/{address} MCP->>API: GET /v2/token/{chain}/{address}/security MCP->>API: GET /v2/token/{chain}/{address}/topHolders API-->>MCP: 代币数据 + 安全标志 + 持有者 MCP-->>AI: 结构化分析结果 AI-->>User: "该代币无蜜罐风险，
前 10 持有者占比 35%..." ``` ### 连接方式 | 方式 | 端点 | 适用场景 | | ------------- | -------------------------------- | -------------------------------- | | **云端** | `https://mcp.chainstream.io/mcp` | 零安装，始终最新 | | **npm stdio** | `npx @chainstream-io/mcp` | 本地 IDE 集成（Claude Desktop、Cursor） | *** ## 与传统 API 的区别 | 特性 | 传统 API | MCP | | ---- | --------- | -------- | | 调用方式 | HTTP REST | 协议标准化 | | 目标用户 | 开发者 | AI 模型 | | 参数处理 | 手动构建 | AI 自动推断 | | 错误处理 | 返回状态码 | 语义化错误 | | 上下文 | 无状态 | 可保持会话上下文 | *** ## 认证方式 ChainStream MCP Server 通过 **API Key** 认证。在 [ChainStream Dashboard](https://www.chainstream.io/dashboard) 获取 Key，然后根据传输方式配置： | 传输方式 | 如何传递 API Key | | ---------------- | ---------------------------------------------- | | **npm 包**（stdio） | `CHAINSTREAM_API_KEY` 环境变量或 `--api-key` CLI 参数 | | **云端端点** | `X-API-KEY` 请求头 | ```bash theme={null} # Stdio：设置环境变量 export CHAINSTREAM_API_KEY=your-key chainstream-mcp # Stdio：或使用 CLI 参数 chainstream-mcp --api-key your-key ``` API Key 除非你在 Dashboard 设置了过期时间，否则不会过期。无需刷新 Token。 *** ## 安全模型 所有连接方式均通过 API Key 认证。npm 包从环境变量读取 `CHAINSTREAM_API_KEY`。云端端点接受 `X-API-KEY` 请求头。 工具按风险等级分类： * **只读工具**：代币搜索、钱包画像、市场数据 — 默认安全 * **交易工具**（`dex_swap`、`dex_create_token`、`transaction_send`）：标记为高风险，MCP 客户端应要求用户明确确认 所有工具调用都有完整记录，可在 Dashboard 查看。 *** ## 下一步 5 分钟完成 MCP Server 配置 查看所有可用工具详情