Skip to main content

MCP Server for TableGIS - Geospatial data processing tools for AI assistants

Project description

TableGIS MCP Server

Geospatial data processing tools for AI assistants via the Model Context Protocol (MCP).

Wraps tablegis functions as MCP tools, enabling AI clients (Claude Desktop, Cursor, etc.) to perform spatial analysis through natural language.

Tools

Tool Description
nearest_neighbor_one_table Find nearest n neighbors within a single point dataset
nearest_neighbor_two_tables Find nearest n points from dataset B for each point in dataset A
create_buffer Create circular or ring buffers around points (metres)
create_polygon Create regular or star polygons around points
create_sector Create sector (wedge) polygons for directional coverage
points_to_geodataframe Convert lon/lat columns to Point geometries
calculate_area Calculate polygon areas in square metres
buffer_geometries Expand/shrink existing geometries by a distance
cluster_by_distance Group nearby points into clusters by buffer distance
convert_coordinates Convert between Chinese coordinate systems (WGS84/GCJ02/BD09)
match_spatial_layer Spatial join: match points to a polygon layer file

Install

pip install tablegis-mcp

Or use with uvx (no install needed):

uvx tablegis-mcp

Configure

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tablegis": {
      "command": "uvx",
      "args": ["tablegis-mcp"]
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "tablegis": {
      "command": "python",
      "args": ["-m", "tablegis_mcp.server"]
    }
  }
}

Claude Code

Add to ~/.claude.json (global) or project-level .claude/settings.json:

{
  "mcpServers": {
    "tablegis": {
      "command": "uvx",
      "args": ["tablegis-mcp"]
    }
  }
}

Or with pip:

{
  "mcpServers": {
    "tablegis": {
      "command": "python",
      "args": ["-m", "tablegis_mcp.server"]
    }
  }
}

Cursor / Other MCP Clients

Use the same command configuration. The server communicates via stdio transport.

Usage Examples

Once configured, you can ask your AI assistant:

  • "Find the 3 nearest neighbors for each point in this dataset"
  • "Draw 3km delivery zones around these store locations"
  • "Calculate the area of each polygon in square metres"
  • "Group points within 500m into clusters"
  • "Match these coordinates to a shapefile of administrative boundaries"
  • "Convert these WGS84 coordinates to GCJ-02 (Amap/高德)"

Data is passed as CSV or JSON strings; geometry results are returned as WKT.

Development

git clone https://github.com/Non-existent987/tablegis-mcp.git
cd tablegis-mcp
pip install -e ".[dev]"

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tablegis_mcp-0.1.1.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tablegis_mcp-0.1.1-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file tablegis_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: tablegis_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 9.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.10

File hashes

Hashes for tablegis_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 fdfb753be7217eeb67047f6f6b76a71c1c11a1ee632423e7f3472f223a67b1bf
MD5 6ce1b3c148e9849b634ec1c674e7bc61
BLAKE2b-256 58dec9a810536b65514dd13b582b3efaf7d0b059fed6f4f6e8710bd244bdb877

See more details on using hashes here.

File details

Details for the file tablegis_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: tablegis_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.10

File hashes

Hashes for tablegis_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c5dbebea8a6e633fe633bbdc2e482ce54295cef5d5d1bc12f7eb76c64ac4d5ac
MD5 b4fe01b7ae5719aaf249bc93e1fbb6ea
BLAKE2b-256 edd28ccb70e53931f6dab7b89cd0524f3806094c98a2f70fb78dfa23b7d303a5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page