MCP

泰芯文档 MCP 服务器

把 AI 编程工具接入泰芯公开资料检索能力,用于查询产品、方案、下载资料和技术文档。接入时需要 OAuth 登录授权,以保护账户访问安全。

服务器地址
https://taixin-semi.com/api/mcp
同域兼容地址
https://taixin-semi.com/api/mcp

Cursor

{
  "mcpServers": {
    "taixin-documentation": {
      "url": "https://taixin-semi.com/api/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "taixin-documentation": {
      "type": "http",
      "url": "https://taixin-semi.com/api/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http --scope user taixin-documentation "https://taixin-semi.com/api/mcp"

ChatGPT (Codex)

codex mcp add taixin-documentation --url "https://taixin-semi.com/api/mcp"
codex mcp login taixin-documentation

VS Code 安装状态说明

如果命令面板中的“MCP: List Servers”已经出现 taixin-documentation,但详情页仍显示“安装”,这是部分 VS Code 版本的界面状态问题,不要重复点击。还应从服务器列表查看输出或打开工具选择器,确认服务器能够启动。

可靠的 CLI 备用方式(PowerShell 或 macOS/Linux 终端)
code --add-mcp '{"name":"taixin-documentation","type":"http","url":"https://taixin-semi.com/api/mcp"}'

可用工具

search_taixin_sources

按具体产品、资料、参数、支持、公司或应用问题检索泰芯公开来源。

query、language

get_taixin_product_specs

按 TXW8301 这类泰芯型号返回公开产品参数来源。

model、language

find_taixin_downloads

按泰芯产品或主题查找数据手册、说明书、SDK、下载资料和技术文档。

query、language

compare_taixin_products

按两个具体泰芯型号检索公开产品和技术来源,用于对比参考。

leftModel、rightModel、language

验证是否真正连通

  1. 在 MCP 客户端里添加服务器地址。
  2. 客户端提示授权时,使用授权页面当前提供的网站邮箱、GitHub 或微信完成登录。
  3. 确认 tools/list 能返回下方四个泰芯工具。
  4. 调用 get_taixin_product_specs,型号填 TXW8301,确认结果引用泰芯公开来源。
  5. 再问一个泛化无关问题,例如“为什么寿命是有限的”,工具应返回 out_of_scope 且不返回来源。

结构化输出

  • 每个工具都会返回 unresolved,方便客户端区分无结果、越界问题和正常命中。
  • primary_source 指向最直接命中的公开来源,sources 提供适合 IDE 展示的标准来源卡片。
  • 每个来源包含 source_url、source_type、title、content 和 score;旧版 results 字段继续保留,兼容已接入客户端。

检索范围与边界

  • 服务器只检索泰芯官网公开资料:产品、方案、下载资料、技术文档、支持和公司信息。
  • 没有泰芯产品、资料、参数、下载或应用上下文的泛化问题会返回 out_of_scope,不会强行给无关来源。
  • 产品参数和产品对比工具需要具体泰芯型号,例如 TXW8301。
  • MCP 不提供后台管理能力,不返回未公开文件、密钥、价格、库存、交期承诺或内部工程结论。

命令行连通性测试

discovery 脚本会验证 OAuth 元数据和动态客户端注册;client smoke 脚本在不提供 token 时验证 OAuth challenge;token smoke 脚本会创建短期测试 token,执行 initialize、tools/list、TXW8301 工具调用和 out_of_scope 泛化问题检查,然后撤销 token。

$env:MCP_TEST_ENDPOINT="https://taixin-semi.com/api/mcp"
node frontend/scripts/mcp-oauth-discovery.test.mjs
node frontend/scripts/mcp-client-smoke.test.mjs

$env:MCP_TEST_BEARER_TOKEN="<access-token>"
node frontend/scripts/mcp-client-smoke.test.mjs

$env:MCP_TEST_ISSUE_TOKEN="1"
$env:MCP_TEST_DATABASE_URL="<database-url>"
node frontend/scripts/mcp-token-tool-call-smoke.test.mjs