# Geopy Mcp

> MCP Server exposing GeoPy data via the Model Context Protocol.

- **Type:** MCP server
- **Install:** `agentstack add mcp-cssnr-geopy-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cssnr](https://agentstack.voostack.com/s/cssnr)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cssnr](https://github.com/cssnr)
- **Source:** https://github.com/cssnr/geopy-mcp
- **Website:** https://cssnr.github.io

## Install

```sh
agentstack add mcp-cssnr-geopy-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](https://github.com/cssnr/geopy-mcp/releases/latest)
[](https://pypi.org/project/geopy-mcp/)
[](https://github.com/cssnr/geopy-mcp/pkgs/container/geopy-mcp)
[](https://github.com/cssnr/geopy-mcp/pkgs/container/geopy-mcp)
[](https://pypi.org/project/geopy-mcp/)
[](https://github.com/cssnr/geopy-mcp/actions/workflows/build.yaml)
[](https://github.com/cssnr/geopy-mcp/actions/workflows/deploy.yaml)
[](https://github.com/cssnr/geopy-mcp/actions/workflows/release.yaml)
[](https://github.com/cssnr/geopy-mcp/pulse)
[](https://github.com/cssnr/geopy-mcp?tab=readme-ov-file#readme)
[](https://github.com/cssnr/geopy-mcp?tab=readme-ov-file#readme)
[](https://github.com/cssnr/geopy-mcp/graphs/contributors)
[](https://github.com/cssnr/geopy-mcp/issues)
[](https://github.com/cssnr/geopy-mcp/discussions)
[](https://github.com/cssnr/geopy-mcp/forks)
[](https://github.com/cssnr/geopy-mcp/stargazers)
[](https://cssnr.github.io/)
[](https://discord.gg/wXy6m2X8wY)
[](https://ko-fi.com/cssnr)

# GeoPy MCP

- [Setup](#setup)
  - [Local](#local)
  - [Remote](#remote)
- [Development](#development)
- [Building](#building)
- [Support](#support)
- [Contributing](#contributing)

MCP Server exposing [GeoPy](https://github.com/geopy/geopy) data via the Model Context Protocol.

## Setup

This can be run in [Local](#local) CLI mode or [Remote](#remote) server mode.

### Local

In CLI mode using `uv`.

View Config - Local uv

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "geopy": {
      "type": "local",
      "command": ["uvx", "geopy-mcp"],
      "enabled": true
    }
  }
}
```

In CLI mode using Python pip.

```shell
pip install geopy-mcp
```

View Config - Local Python

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "geopy": {
      "type": "local",
      "command": ["geopy-mcp"],
      "enabled": true
    }
  }
}
```

### Remote

With Docker run.

```shell
docker run --rm -p 80:8000 ghcr.io/cssnr/geopy-mcp:latest
```

With Docker Compose.

```yaml
services:
  app:
    image: ghcr.io/cssnr/geopy-mcp:latest
    ports:
      - '80:8000'
```

With Python from source.

```shell
uv sync
uv run uvicorn geopy_mcp.server:app --app-dir src --host 0.0.0.0 --port 8000
```

View Config - Remote

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "geopy": {
      "type": "remote",
      "url": "http://localhost/mcp",
      "enabled": true
    }
  }
}
```

Note: Set the `url` to the host you are running the server on.

[](https://render.com/deploy?repo=https://github.com/cssnr/geopy-mcp)

For a Docker Swarm + Traefik example see the [docker-compose-swarm.yaml](https://github.com/cssnr/geopy-mcp/blob/master/docker-compose-swarm.yaml).

For a Portainer Deploy workflow see the [.github/workflows/deploy.yaml](https://github.com/cssnr/geopy-mcp/blob/master/.github/workflows/deploy.yaml).

## Development

Sync project.

```shell
uv sync
```

Run local server.

```shell
run cli
```

Run remote server (live reload).

```shell
run dev
```

Point your client to: http://localhost:8000/mcp

Run remote Docker Compose (live reload).

```shell
run compose
```

Point your client to: http://localhost/mcp

You can set the `PORT` environment variable.

## Building

### Docker Image

To build and test the docker image run.

```shell
bash build.sh
docker compose up
```

Point your client to: http://localhost/mcp

### Python Package

This builds the bdist and wheel, if you have a use for it...

```shell
run build
```

## Support

If you run into any issues or need help getting started, please do one of the following:

- Report an Issue: 
- Q&A Discussion: 
- Request a Feature: 
- Chat with us on Discord: 

[](https://github.com/cssnr/geopy-mcp/issues/new?template=1-feature.yaml)
[](https://github.com/cssnr/geopy-mcp/issues)
[](https://github.com/cssnr/geopy-mcp/discussions)
[](https://discord.gg/wXy6m2X8wY)

## Contributing

Please consider making a donation to support the development of this project
and [additional](https://cssnr.com/) open source projects.

[](https://ko-fi.com/cssnr)

For a full list of current projects visit: [https://cssnr.github.io/](https://cssnr.github.io/)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cssnr](https://github.com/cssnr)
- **Source:** [cssnr/geopy-mcp](https://github.com/cssnr/geopy-mcp)
- **License:** MIT
- **Homepage:** https://cssnr.github.io

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-cssnr-geopy-mcp
- Seller: https://agentstack.voostack.com/s/cssnr
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.