AI导哈

城市API服务器

用于访问City By Api Ninjas API的MCP服务器，提供城市数据查询功能。

  • by BACH-AI-Tools
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 BACH-AI-Tools/city_by_api_ninjas

使用说明

City By Api Ninjas MCP Server

English |Simplified Chinese| Traditional Chinese

MCP server used to access City By Api Ninjas API.

🚀 Quickly experience using the EMCP platform

EMCP It is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!

Quick Start:

  1. 🌐 visit EMCP platform
  2. 📝 Register and log in to your account
  3. 🎯 enter MCP SquareBrowse all available MCP servers
  4. 🔍 Search or find this server（bach-city_by_api_ninjas）
  5. 🎉 click Install MCP button
  6. ✅ Done! Can be used in your application

Advantages of the EMCP platform:

  • ✨ Zero configurationNo need to manually edit configuration files
  • 🎨 Visual managementEasily manage all MCP servers through a graphical interface
  • 🔐 safe and reliableUnified management of API keys and authentication information
  • 🚀 One-click installationMCP Square offers a wide range of server options
  • 📊 Use statisticsReal time viewing of service invocation status

Visit Now EMCP platform Start your MCP journey!

Introduction

This is an MCP server used to access the City By Api Ninjas API.

  • PyPI package name: bach-city_by_api_ninjas
  • version: 1.0.0
  • transmission protocol: stdio

install

Install from PyPI:

pip install bach-city_by_api_ninjas

Install from source code:

pip install -e .

run

Method 1: Use UVX (recommended, no installation required)

# 运行（uvx 会自动安装并运行）
uvx --from bach-city_by_api_ninjas bach_city_by_api_ninjas

# 或指定版本
uvx --from bach-city_by_api_ninjas@latest bach_city_by_api_ninjas

Method 2: Direct Run (Development Mode)

python server.py

Method 3: Run as a command after installation

# 安装
pip install bach-city_by_api_ninjas

# 运行（命令名使用下划线）
bach_city_by_api_ninjas

configuration

API certification

This API requires authentication. Please set environment variables:

export API_KEY="your_api_key_here"

environment variable

Variable Name Description Required
API_KEY API Key Yes
PORT Not applicable No
HOST Not applicable No

Use in cursor

Edit cursor MCP configuration file ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bach-city_by_api_ninjas": {
      "command": "uvx",
      "args": ["--from", "bach-city_by_api_ninjas", "bach_city_by_api_ninjas"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Using Claude Desktop

Edit Claude Desktop configuration file claude_desktop_config.json:

{
  "mcpServers": {
    "bach-city_by_api_ninjas": {
      "command": "uvx",
      "args": ["--from", "bach-city_by_api_ninjas", "bach_city_by_api_ninjas"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

This server provides the following tools:

v1city

API Ninjas City API endpoint.

endpoint: GET /v1/city

parameter:

  • name (string): Name of city.

  • country (string): Country filter. Must be an ISO-3166 alpha-2 code (e.g. US).

  • min_population (number): Minimum city population.

  • max_population (number): Maximum city population.

  • min_lat (number): Minimum latitude coordinate.

  • max_lat (number): Maximum latitude coordinate.

  • min_lon (number): Minimum longitude coordinate.

  • max_lon (number): Maximum longitude coordinate.

  • limit (number): How many results to return. Must be between 1 and 30. Default is 1.

tech stack

  • transmission protocol: stdio
  • HTTP client: httpx

license

MIT License - see details LICENSE Document.

development

This server is composed of API-to-MCP Tool generation.

Version: 1.0.0

相关 MCP