提供越南股市金融数据的非官方MCP服务器，允许您使用自然语言处理功能与Claude Desktop进行交互。
特性
- 双重运输支持：自动检测STDIO（本地）或HTTP（云）传输
- 云部署：一键部署到Render.com免费层
- LLM供电：使用Anthropic Claude进行自然语言处理
- 美丽的输出：格式化的表格、图表和数据可视化
- 工具管理：自动工具发现和验证
- 智能解析：支持越南股票代码和日期格式
- 错误处理：强大的错误恢复和用户友好的消息
快速开始
# Install from PyPI and run directly
uvx vnstock-mcp@latest用法示例
> Show me FPT's income statements for 2024
> What are HPG's key financial ratios?数据源
此服务器使用vnstock 4.x公共适配器：
- 财务报表和比率的使用
Finance(source="KBS")为了一致item,item_id，以及周期列输出。金融标签是供应商原生的；使用item_id用于稳定的度量识别。 - 公司信息使用
Company(source="VCI")因为ratio_summary和trading_stats是VCI特定的兼容性方法。 - 共同基金数据使用顶级
Fund适配器。
财务报表和比率响应以带有期间列的度量行形式返回：
item | item_id | 2025 | 2024 | 2023 | 2022这 reports vnstock4.x不支持公司信息类型，已将其删除。
Claude桌面集成
要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop配置文件中(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
方法1：使用uvx（如果配置了PATH）
{
"mcpServers": {
"vnstock-mcp": {
"command": "uvx",
"args": ["vnstock-mcp"]
}
}
}方法2：使用uvx（如果未配置PATH）
{
"mcpServers": {
"vnstock-mcp": {
"command": "/Users/YOUR_USERNAME/.local/bin/uvx",
"args": ["vnstock-mcp"]
}
}
}方法3：从源代码开发（脚本路径）
{
"mcpServers": {
"vnstock-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/USERNAME/PATH_TO/src/vnstock_mcp",
"run",
"server.py"
]
}
}
}方法4：从源代码开发（Python模块）
{
"mcpServers": {
"vnstock-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/USERNAME/PATH_TO/vnstock-mcp",
"run",
"python",
"-m",
"vnstock_mcp.server"
]
}
}
}方法5:Docker MCP网关（简单）
{
"mcpServers": {
"MCP_DOCKER": {
"type": "stdio",
"command": "docker",
"args": ["mcp", "gateway", "run"]
}
}
}方法6:Docker MCP网关（显式目录/注册表）
{
"mcpServers": {
"mcp-toolkit-gateway": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/var/run/docker.sock:/var/run/docker.sock",
"-v",
"/Users/YOUR_USERNAME/.docker/mcp:/mcp",
"docker/mcp-gateway",
"--catalog=/mcp/catalogs/vnstock.yaml",
"--config=/mcp/config.yaml",
"--registry=/mcp/registry.yaml",
"--transport=stdio"
]
}
}
}注：
- 替换
YOUR_USERNAME在方法2和6中使用您的实际用户名 - 替换
USERNAME和PATH_TO在方法3和4中使用您的实际用户名和路径 - 方法5和6要求 启用MCP工具包。看 安装指南 详见
- 方法5让Docker自动管理目录；方法6引脚特定的目录、配置和注册表文件
- 退出并重新启动Claude Desktop后，如果仍然无法检测到mcp服务器，请检查
uvx在你的路径。如果没有，请添加~/.local/bin到你的路径：
# For zsh (macOS default)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# For bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcClaude代码集成
claude mcp add vnstock-mcp --transport http https://your-app.onrender.com/mcp远程MCP服务器
连接到部署在Render（或任何云提供商）上的托管VNStock MCP服务器，而无需在本地安装任何东西。远程服务器在以下位置公开了一个可流式传输的HTTP端点 /mcp.
使用服务器URL https://your-app.onrender.com/mcp 当在每个客户端的GUI中添加远程MCP服务器时。每位客户的指南：
- 克劳德桌面版 --通过设置>MCP服务器添加
- 克劳德代码（CLI） —
claude mcp add vnstock-mcp https://your-app.onrender.com/mcp --transport http - 困惑度 --跟随 添加自定义远程连接器
注： 替换 your-app.onrender.com 使用您的实际渲染部署URL并添加 /mcp 最后。
您可以验证服务器是否使用自定义运行状况终结点运行 /health 这样地：
curl https://your-app.onrender.com/health当服务从标记的git checkout运行时 version 领域 /health 报告该标签。适用于没有 .git，它将回退到已安装的包元数据或 VNSTOCK_MCP_VERSION.
发展
设置docker mcp网关 安装指南
项目结构、Docker构建和部署指南，请参阅 开发指南.
解决常见问题的技巧包括快速诊断命令、验证目录、注册表、验证Claude Config、身份验证和权限 故障排除指南
许可证
这个项目是vnstock库的包装器。有关许可和API信息，请参阅主存储库和文档：