Bamwor Mcp Server

io.github.bamwor-dev由 GitHub 账号 bamwor-dev 发布v0.2.2更新于 Oct 24, 2026

World geographic data for AI agents: 261 countries, 5.2M cities, rankings, and 9 indexes.

已验证STDIO仅桌面位置与生活数据与分析

概览

AI 生成的概览

一个本地 MCP 服务器，为助手提供全球地理数据：国家资料、城市搜索、排名、对比和周边城市查询。

可以做什么
按名称、slug 或 ISO 代码查询和搜索国家，返回人口、面积、首都和统计数据，并可在 GDP、HDI、预期寿命等指标上并排比较两个国家。搜索全球城市，或按最低人口筛选列出某国城市。按 GeoNames ID 获取城市详情，包括坐标、海拔和时区，并查找其半径内的附近城市。按人口、面积、GDP、HDI、预期寿命或九个 Bamwor 专有指数获取国家排名。
适用场景
适合助手在研究、对比、排名或地点背景中需要可靠的国家或城市数据时使用，无需自建地理数据集。适用于涉及地点的分析和写作任务，而非实时地图或路线规划。
运行要求
通过 npx 或全局 npm 安装后在本地运行，需要 Node.js。它会通过网络调用 Bamwor API；可选的 BAMWOR_API_KEY 可提升访问权限和速率限制，API 基础地址和请求超时可通过环境变量覆盖。
安装前请注意
API 密钥以明文形式通过环境变量传入，请勿放入共享配置文件。查询会发送到第三方 Bamwor API，所查地点和关键词会离开本机。数据为只读，但数值来自外部来源和专有指数，重要结果应自行核实。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Bamwor Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

bamwor-mcp-server

MCP Server for world geographic data — 261 countries, 13.4M cities. Connect AI agents to real country and city data.

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Quick Start

bash
npx bamwor-mcp-server

Or install globally:

bash
npm install -g bamwor-mcp-serverbamwor-mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "bamwor-world-data": {      "command": "npx",      "args": ["-y", "bamwor-mcp-server"],      "env": {        "BAMWOR_API_KEY": "your_api_key"      }    }  }}

Cursor / Windsurf

Add to your MCP settings:

json
{  "bamwor-world-data": {    "command": "npx",    "args": ["-y", "bamwor-mcp-server"],    "env": {      "BAMWOR_API_KEY": "your_api_key"    }  }}

Environment Variables

VariableRequiredDefaultDescription
BAMWOR_API_KEYNo(anonymous)API key for full access. Get one free at bamwor.com/en/developers/quickstart
BAMWOR_API_URLNohttps://bamwor.com/api/v1API base URL override
BAMWOR_REQUEST_TIMEOUTNo15000Request timeout in ms

Available Tools (8)

get_country

Get detailed data about a country by name, slug, or ISO code. Returns population, area, capital, region, coordinates, and 20+ statistics.

Input: { "query": "Japan" }

search_countries

Search for countries by name or keyword. Returns matching countries with basic data.

Input: { "query": "south", "limit": 10 }

search_cities

Search for cities worldwide by name from a database of 13.4M cities.

Input: { "query": "Tokyo", "limit": 5 }

list_cities_by_country

List cities in a specific country, sorted by population or name. Supports minimum population filter.

Input: { "country": "brazil", "min_population": 1000000, "limit": 10 }

compare_countries

Compare two countries side by side across all available metrics: population, area, GDP, HDI, life expectancy, and more.

Input: { "country_a": "France", "country_b": "Germany" }

get_rankings

Get country rankings by metric. Available metrics: population, area, gdp, hdi, life-expectancy, and 9 Bamwor proprietary indices (ibeu, ibcp, ibda, ibcx, ibee, ibfm, ibdi, ibed, ibsa). Omit metric to list all available.

Input: { "metric": "population", "limit": 10, "countries_only": true }

get_city

Get detailed information about a specific city by its GeoNames ID. Returns coordinates, population, elevation, timezone, and province.

Input: { "city_id": 1850147 }

get_nearby_cities

Find cities near a specific city using PostGIS radius search. Returns nearby cities with distance in km.

Input: { "city_id": 1850147, "radius": 50, "limit": 10 }

Data Coverage

  • 261 countries and territories with 20+ statistics each
  • 13.4 million cities with coordinates, population, elevation, timezone
  • 9 proprietary indices (IBEU, IBCP, IBDA, IBCX, IBEE, IBFM, IBDI, IBED, IBSA)
  • Rankings by any metric
  • Country comparisons — 67,860 combinations
  • 4 languages — English, Spanish, Portuguese, Italian

Data sourced from CIA World Factbook, GeoNames, UNDP, and World Bank.

Links

License

MIT

来源：README.md，提交 8ce0b15

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分