English Français العربية

io.github.bamwor-dev/bamwor-mcp-server

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package bamwor-mcp-server
Claude Code 
claude mcp add bamwor-mcp-server -e 'BAMWOR_API_KEY=<your bamwor_api_key>' -- npx -y bamwor-mcp-server@0.2.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bamwor-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "bamwor-mcp-server@0.2.2"
            ],
            "env": {
                "BAMWOR_API_KEY": "<your bamwor_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BAMWOR_API_KEY سري Optional. Bamwor API key for full access and higher rate limits. Works anonymously without it. Get one free at https://bamwor.com/en/developers/quickstart

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. bamwor-mcp-server
  2. Quick Start
  3. Configuration
  4. Available Tools (8)
  5. Data Coverage
  6. Links
  7. License

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

npx bamwor-mcp-server

Or install globally:

npm install -g bamwor-mcp-server
bamwor-mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.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:

{
  "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.

License

MIT

الأسئلة الشائعة

ما هو io.github.bamwor-dev/bamwor-mcp-server؟

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

كيف أثبّت io.github.bamwor-dev/bamwor-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add bamwor-mcp-server -e 'BAMWOR_API_KEY=<your bamwor_api_key>' -- npx -y bamwor-mcp-server@0.2.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.bamwor-dev/bamwor-mcp-server إلى مفتاح API؟

نعم. يتطلب BAMWOR_API_KEY، وتضبطها في إعداداته.

هل io.github.bamwor-dev/bamwor-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.bamwor-dev/bamwor-mcp-server؟

ينشره bamwor-dev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.