MCP Bgs Mineral Stats

BGS矿产统计MCP服务器

通过模型上下文协议，获取英国地质调查局提供的全球矿产生产、进口和出口数据（1970年至今）。

快速入门

1. 安装依赖项

pip install -r requirements.txt

2. 配置Claude桌面版

在您的Claude Desktop配置文件中添加：

Windows: %APPDATA%\Claude\claude_desktop_config.json\ macOS（苹果电脑操作系统）: ~/Library/Application Support/Claude/claude_desktop_config.json\ Linux（发音类似“林克斯”，但通常直接音译为“林乌克斯”或保持原英文形式不译，根据语境可灵活处理）： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bgs-minerals": {
      "command": "fastmcp",
      "args": ["run", "D:\\path\\to\\bgs-mineral-stats\\server.py"]
    }
  }
}

重要的替换 D:\\path\\to\\bgs-mineral-stats 使用您实际的安装目录。

3. 重启Claude桌面版

保存配置后，重启Claude Desktop。BGS Minerals工具将可用。

你可以提出的问题

配置完成后，可以向Claude提出如下问题：

• “2020年至2022年全球铜产量是多少？”
• “2015年至2020年间，哪些国家出口的锂最多？”
• “给我展示过去5年的黄金进口详细数据”
• “有哪些矿产商品可供选择？”
• “比较2018-2023年全球五大镍生产国的产量”

可用工具

1. get_commodity_data

查询任何矿产品的生产、进口和出口情况。

参数：

• commodity - 矿物名称（例如，“铜”，“锂”，“金”）
• year_from - 开始年份（1970年至今）
• year_to - 年末（1970年至今）
• response_format -“简洁”（摘要）或“详细”（逐年）

退货汇总统计：主要生产商/进口商/出口商

2. search_commodities

查找可用商品或按关键词搜索。

参数：

• search_term - 可选关键字过滤器

退货可用商品名称列表

3. get_capabilities

获取WFS服务信息和故障排除帮助。

回报服务元数据和文档链接

可用商品

目前支持（18种矿物）：

• 锑、铝土矿、铬、钴、铜
• 黄金、石墨、铁矿石、铅、锂
• 锰、镍、铂、稀土元素
• 银、锡、钨、锌

使用 search_commodities 探索所有选项的工具。

数据源

提供者英国地质调查局（BGS）\ 数据集世界矿产统计\ 许可证开放政府许可\ 覆盖范围1970年至今，全球各国，主要矿产\ 文档https://www.bgs.ac.uk/technologies/web-services/ 翻译为中文是：“英国地质调查局（BGS）技术网页服务”。不过，为了更贴近原文的网址表述习惯，我们也可以将其意译为：“英国地质调查局的网络服务技术页面”。但通常在中文语境下，直接提及网址时，我们不会完全翻译网址内容，而是保留原网址形式，仅对网址所代表的含义进行简要说明或翻译其标题（如果有的话）。在这里，由于网址本身没有标题，所以主要翻译的是网址所指向的内容或页面的大致主题

故障排除

服务器无法启动

# Check Python version (requires 3.8+)
python --version

# Verify dependencies installed
pip list | grep -E "fastmcp|httpx|pydantic"

# Test imports
python -c "from fastmcp import FastMCP; print('OK')"

未返回数据

1. 使用 get_capabilities 检查服务状态
2. 使用 search_commodities 验证商品名称
3. 尝试使用较小的年份范围（例如，2020-2022）
4. 检查网络连接

超时错误

• BGS服务可能处于高负载状态
• 请过一会儿再试
• 缩短年份范围以加快响应速度

技术细节

• 协议OGC WFS 2.0.0（开放地理空间联盟网络功能服务2.0.0）
• 格式GeoJSON
• 超时30秒
• 字符限制每条回复25,000（元/其他货币单位）
• 建筑学单线程异步Python服务器

发展

项目结构

bgs-mineral-stats/
├── server.py          # MCP server (clean, production-ready)
├── requirements.txt   # Python dependencies
└── README.md         # Documentation

添加商品

编辑 COMMODITY_URIS 字典中的 server.py：

COMMODITY_URIS = {
    "commodity-name": "http://resource.geosciml.org/classifier/cgi/commodity-code/code",
    # Add more here
}

在以下网址查找CGI代码：http://resource.geosciml.org/classifier/cgi/commodity-code/

许可证

服务器实现：MIT（或您选择的其他方式）\ 数据：开放政府许可（英国地质调查局 © 英国研究与创新局）

支持

• 英国地质调查局（BGS）网络服务：https://www.bgs.ac.uk/technologies/web-services/
• MCP（Model Context Protocol，模型上下文协议）文档：https://modelcontextprotocol.io/
• FastMCP：https://github.com/modelcontextprotocol/python-sdk