企业官网建设流程全解析

1. MCP 数据库查询链路里 local proxy failed 到底卡在哪

MCP 数据库查询，简单说就是让大模型通过模型上下文协议（Model Context Protocol）去连你的 MySQL，用自然语言问一句“中国在哪个洲”，它自己生成 SQL 再返回结果。适合谁？适合手头有业务库、想让 AI 帮忙做数据探索的开发者，也适合刚接触 MCP、想跑通第一个数据库 server 的人。

我试过用 xiyan-mcp-server 接本地 MySQL，第一次跑就撞上local proxy failed。这个报错很迷惑，因为它既不像鉴权错误那样直接甩 401，也不像 SQL 语法错误那样告诉你哪一行有问题，它只说“本地代理失败”。后来拆开看，MCP 数据库查询这条链路其实有三段：客户端（Inspector 或 Cline）→ 模型服务端点 → 数据库。local proxy failed通常出在第一段到第二段之间，也就是客户端把请求发给模型端点时，代理层没接住。

为什么叫“local proxy”？因为很多 MCP 客户端在本地起了一个转发进程，把 MCP 的 stdio 或 SSE 流量转成 HTTP 请求发给模型服务。这个转发进程如果配置的 endpoint 不对、Key 没带上、或者端口被占，就会报 local proxy failed。它跟数据库本身没关系，数据库连不上会报另一个错。

所以排查顺序应该是：先确认客户端配置里的 endpoint 和 Key，再确认模型服务能不能通，最后才看数据库。很多人一上来就查 MySQL 权限，方向反了。下面我按这个顺序，把可复制的配置和验证动作写清楚。

2. TaoToken 前置：把模型端点和 Key 准备好

MCP 数据库查询要跑通，模型服务这一环不能少。xiyan-mcp-server 的配置文件里有一个model段，需要填name、key、url。这个url就是模型服务的 endpoint，key就是访问凭证。如果你用 TaoToken 作为模型服务入口，这一步就是把 endpoint 和 Key 拿到手。

先打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 了解服务范围，然后进控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。创建完 Key 之后，在 API Keys 页面可以复制，页面地址 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

这里有个关键点：MCP 客户端配置里填的 Base URL 和 Key，必须和你在控制台看到的一致。Base URL 用 https://taotoken.net/api ，注意这个地址不带 UTM 参数，直接写进配置文件。Key 就是sk-开头的那串。

模型 ID 怎么选？xiyan-mcp-server 默认配置里写的是qwen2.5_7b，但你可以换成 TaoToken 支持的任意模型 ID。如果你不确定有哪些可用，可以到模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 先试一下，确认模型能正常回复，再写进 MCP 配置。

为什么要先做这一步？因为local proxy failed很多时候就是 endpoint 写错或 Key 失效导致的。你先把模型服务单独验证通，再接到 MCP 里，就能排除掉一大半干扰项。我踩过的坑是：配置文件里 url 写成了http://192.168.*.*:*/v1这种内网地址，结果本地代理转发时根本连不上，报的就是 local proxy failed。换成 TaoToken 的 https 端点后，问题直接消失。

另外，如果你打算长期跑 MCP 数据库查询、或者做 Agent 类任务，可以看一下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它更适合高频调用场景。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有各语言的调用示例。

3. 可复制配置：xiyan-mcp-server 的 config.yml 与客户端 settings

这一节给可直接复制的配置片段。先看 xiyan-mcp-server 的config.yml，路径按你实际存放位置来，比如C:/Users/liangr/Desktop/H20/mcp/config.yml。内容如下：

model: name: "qwen2.5_7b" key: "sk-你的TaoTokenKey" url: "https://taotoken.net/api/v1" database: host: "localhost" port: 3306 user: "root" password: "你的数据库密码" database: "world"

注意url这里写的是https://taotoken.net/api/v1，因为 xiyan-mcp-server 内部会拼/chat/completions。如果你用的客户端要求填 Base URL，那就填https://taotoken.net/api，不要带/v1，具体看客户端说明。Key 就是你在 API Keys 页面复制的那串。

接下来是 MCP Inspector 的启动命令。Inspector 是官方提供的调试工具，用来测试 MCP server 是否正常。命令如下：

npx @modelcontextprotocol/inspector -e YML=C:/Users/liangr/Desktop/H20/mcp/config.yml python -m xiyan_mcp_server

跑起来后打开 http://localhost:5173 ，在界面里能看到 server 暴露的工具列表。如果这里就报 local proxy failed，说明 Inspector 到模型端点的转发有问题，重点检查config.yml里的url和key。

如果你用的是 Cline 或 Claude Code 这类客户端，配置方式不一样。以 Cline 的 MCP 配置为例，通常写在settings.json或 MCP 配置面板里，格式类似：

{ "mcpServers": { "xiyan-mysql": { "command": "python", "args": ["-m", "xiyan_mcp_server"], "env": { "YML": "C:/Users/liangr/Desktop/H20/mcp/config.yml" } } } }

这里没有直接写 Base URL 和 Key，因为它们藏在config.yml里。但如果你用的是 Claude Code 的 Anthropic 兼容模式，可能需要在settings.json里额外指定：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoTokenKey", "ANTHROPIC_MODEL": "qwen2.5_7b" } }

这三件套——Base URL、Key、Model ID——必须同时正确。少一个就会在代理层被拦，报 local proxy failed 或 401。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite ，里面有完整的环境变量说明。

配置改完后，记得重启 MCP 客户端。很多客户端不会热加载配置，改了不重启等于没改。这是最容易忽略的一步。

4. 验证请求：发一次数据库查询看结果

配置写好后，怎么确认 MCP 数据库查询真的通了？最直接的办法是发一次自然语言查询，看它能不能生成 SQL 并返回结果。

在 MCP Inspector 的界面里，找到 xiyan-mcp-server 暴露的工具，通常叫query或类似名字。在输入框里填一个问题，比如“中国在哪个洲？”。点执行后，观察返回。

正常的情况下，你会看到类似这样的输出：模型先根据数据库 schema 生成一段 SQL，比如SELECT Continent FROM country WHERE Name = 'China';，然后执行这段 SQL，返回Asia。整个过程在 Inspector 的日志里能看到。

如果你想在命令行里验证模型端点本身是否通，可以单独发一个 curl 请求：

curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -d '{ "model": "qwen2.5_7b", "messages": [{"role": "user", "content": "你好"}] }'

如果这个请求返回正常的 JSON，说明模型端点和 Key 没问题。如果返回 401，说明 Key 错了或没带上。如果返回连接错误，说明 endpoint 写错了。这一步能把模型服务的问题和 MCP 配置的问题分开。

再进一步，你可以直接查数据库确认数据存在。用 MySQL 客户端执行：

SELECT Name, Continent FROM country WHERE Name = 'China';

如果数据库里没有这条数据，MCP 查询也会返回空，但那不是 local proxy failed，而是查询结果为空。两者要区分开。

验证通过后，你可以在 Cline 或 Claude Code 里直接问“帮我查一下 world 库里中国在哪个洲”，看它能不能自动调用 MCP 工具。如果能，说明整条链路通了。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

这一节对照真实报错，逐个说排查方向。

401 Unauthorized：Key 错了、Key 没带上、或者 Key 过期。检查config.yml里的key字段，确认是sk-开头且没有多余空格。如果你用的是环境变量方式，确认变量名和客户端要求的一致。TaoToken 的 Key 在 API Keys 页面可以重新生成，页面地址 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

local proxy failed：这是本篇重点。三个可能原因：一是url写错，比如写成了内网地址或少了/v1；二是本地代理端口被占，换个端口或重启客户端；三是客户端到模型端点的网络不通。先确认url是https://taotoken.net/api/v1，再确认 Key 正确，最后看客户端日志里代理进程有没有起来。

reading choices 报错：这个通常出现在模型返回格式不符合预期时。比如模型返回的不是标准 OpenAI 格式，客户端解析choices字段失败。检查你用的模型 ID 是否被 TaoToken 支持，可以到模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 确认该模型能正常返回。如果模型 ID 写错，也可能导致返回体里没有choices。

OAuth 相关报错：如果你用的是 Claude Code 的 Anthropic 兼容模式，可能会遇到 OAuth 流程问题。这时候确认ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY是否设置正确。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite ，按文档里的环境变量配置即可。

还有一个容易忽略的点：MCP server 的 Python 版本。xiyan-mcp-server 要求 Python 3.11，版本不对可能报各种奇怪的错。用python --version确认一下。

排查时建议按顺序来：先 curl 验证模型端点，再跑 Inspector 验证 MCP server，最后在客户端里验证。每步都通了，local proxy failed 自然就没了。

6. 把 MCP 数据库查询接到 TaoToken 的稳定路径

整条链路跑通后，日常使用就是改改config.yml里的数据库连接，模型端点保持https://taotoken.net/api/v1不动。如果你要换模型，改name字段就行，Key 和 URL 不用动。

对于需要长期跑 MCP 数据库查询的场景，比如每天定时让 AI 查业务库生成报表，建议用 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，调用额度更稳。接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里有各客户端的配置示例，遇到新客户端可以直接对照。

最后说一个实用技巧：把config.yml里的数据库密码用环境变量代替，别硬编码在文件里。xiyan-mcp-server 支持从环境变量读取，这样配置文件可以安全地放进版本控制。具体写法是在config.yml里写${DB_PASSWORD}，然后在启动命令前设置环境变量。这样既安全，又方便在不同环境切换。

MCP 数据库查询这条链路，核心就是三件事：模型端点对、Key 对、数据库连接对。local proxy failed 看着吓人，拆开看就是第一件事没做对。把 endpoint 换成 TaoToken 的 https 地址，Key 填对，重启客户端，基本就能恢复。