21.2 mcp-server-chart 图表化作用

如何检查 langchain_mcp_adapters 版本和 @antv/mcp-server-chart 安装

1. 检查 langchain_mcp_adapters 版本

在终端（确保已激活虚拟环境）中运行：

pip show langchain_mcp_adapters

输出示例：

Name: langchain-mcp-adapters
Version: 0.1.9
...

如果未安装，则使用以下命令安装/升级到最新版：

pip install -U langchain-mcp-adapters

2. 检查 Node.js 和 npm 环境

@antv/mcp-server-chart 是 Node.js 包，需要 Node.js 环境。检查是否安装：

node -v
npm -v

如果没有，请从 Node.js 官网 下载安装 LTS 版本。

3. 检查 @antv/mcp-server-chart 是否可用

你可以直接通过 npx 命令测试该包是否能正常启动（临时运行，无需全局安装）：

npx -y @antv/mcp-server-chart

如果包存在且环境正常，你会看到类似 MCP server 启动的日志（可能会输出 Listening on stdio 或报错）。按 Ctrl+C 停止即可。

如果出现 ERR! could not determine executable to run 等错误，说明包未正确安装或网络问题。你可以尝试全局安装：

npm install -g @antv/mcp-server-chart

然后直接运行：

@antv/mcp-server-chart

4. 常见问题排查

• npx 命令找不到：说明 Node.js 未正确安装或未添加到 PATH，请重新安装 Node.js。
• langchain_mcp_adapters 导入错误：确保虚拟环境已激活，并且版本 ≥0.1.9。
• MCP 工具加载后没有 generate_bar_chart 等工具 ：因为该服务提供的工具名称就是这些（如 generate_bar_chart），代码中需要按实际名称调用。你可以在 Python 中打印 tools_map.keys() 确认。

5. 在 Python 代码中验证加载的工具

在 main() 函数中添加以下代码，打印所有工具的名称和参数结构：

print("所有已加载的 MCP 工具：")
for name, tool in tools_map.items():
    print(f"  - {name}")
    if hasattr(tool, 'args_schema') and tool.args_schema:
        try:
            print(f"    参数: {tool.args_schema.schema()}")
        except:
            pass

这样你就可以看到 chart 服务提供的具体工具名（例如 generate_bar_chart）。

如果仍然看不到图表工具，请检查 MCP_SERVERS 中 chart 的配置是否正确，并且本地 8000 端口没有被占用。通常 @antv/mcp-server-chart 使用 stdio 通信，不需要端口。

按照以上步骤，你就能确认环境是否就绪，并正确调用图表工具了。