Skip to main content

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

Metadata

Release files for tablegis-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tablegis-mcp 0.1.1
File Size Uploaded
tablegis_mcp-0.1.1.tar.gz 9.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tablegis-mcp 0.1.1
File Interpreter ABI Platform
tablegis_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 17.9 kB

Release files / tablegis_mcp-0.1.1.tar.gz

Download URL tablegis_mcp-0.1.1.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
fdfb753be7217eeb67047f6f6b76a71c1c11a1ee632423e7f3472f223a67b1bf
BLAKE2b-256 checksum
How to use checksums
58dec9a810536b65514dd13b582b3efaf7d0b059fed6f4f6e8710bd244bdb877
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.10

Release files / tablegis_mcp-0.1.1-py3-none-any.whl

Download URL tablegis_mcp-0.1.1-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c5dbebea8a6e633fe633bbdc2e482ce54295cef5d5d1bc12f7eb76c64ac4d5ac
BLAKE2b-256 checksum
How to use checksums
edd28ccb70e53931f6dab7b89cd0524f3806094c98a2f70fb78dfa23b7d303a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.10

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page