接入指南

配置示例

通过 HTTP JSON-RPC 调用塑库网 MCP endpoint。

环境要求

JSON 请求体

请求体必须是 JSON-RPC 2.0 对象。

自定义请求头

通过 X-MCP-API-Key 传入 pd_mcp_ 开头的完整密钥。

响应解析

调用方需要处理 result、error、content 和 structuredContent。

Endpoint

生产环境请求地址：

text production

https://api.plasdata.com/sokoo/mcp

本地调试如果经过 Nuxt 代理，可以使用 /sokoo/mcp。不要把 MCP API Key 暴露在浏览器端。

curl 示例

当前可用工具包括 tds.search、tds.detail、document.list、document.download 和 price.search。

bash tools/list

curl -X POST "https://api.plasdata.com/sokoo/mcp" \
  -H "Content-Type: application/json" \
  -H "X-MCP-API-Key: pd_mcp_xxx" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

JavaScript 示例

js fetch

const response = await fetch('https://api.plasdata.com/sokoo/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-MCP-API-Key': process.env.PLASDATA_API_KEY,
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 2,
    method: 'tools/call',
    params: {
      name: 'tds.search',
      arguments: {
        keyword: 'PA66',
        limit: 5,
        lang: 'zh',
      },
    },
  }),
})

const payload = await response.json()

Python 示例

python requests

import os
import requests

response = requests.post(
    'https://api.plasdata.com/sokoo/mcp',
    headers={
        'Content-Type': 'application/json',
        'X-MCP-API-Key': os.environ['PLASDATA_API_KEY'],
    },
    json={
        'jsonrpc': '2.0',
        'id': 3,
        'method': 'tools/call',
        'params': {
            'name': 'tds.detail',
            'arguments': {
                'tds_id': 'tds_xxx',
                'lang': 'zh',
            },
        },
    },
)

payload = response.json()