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 端點

配置步驟

驗證配置

測試命令

預期結果

常見問題

下一步