Gxtract MCP Server

@sascharo

Repository Homepage

Basic information

About Gxtract MCP Server

GXtract MCP Server for VS Code, forks and other editors; provides tools for interacting with GroundX

#groundx#mcp#document-understanding

Gxtract MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gxtract": {
      "command": "uv",
      "type": "stdio",
      "args": [
        "--directory",
        "DRIVE:\\path\\to\\your\\gxtract",
        "--project",
        "DRIVE:\\path\\to\\your\\gxtract",
        "run",
        "gxtract",
        "--transport",
        "stdio"
      ],
      "env": {
        "GROUNDX_API_KEY": "${env:GROUNDX_API_KEY}"
      }
    }
  }
}

Gxtract MCP Server tools

Search for documents within your GroundX projects.

Ask specific questions about a document in GroundX.

Get explanations for diagrams, tables, or other semantic objects within documents.

Manually refresh the GroundX metadata cache.

Manually refresh the GroundX projects and buckets cache.

Get statistics about the cached metadata.

List all currently cached GroundX resources (projects, buckets).

Overview

What is GXtract?

GXtract is a Model Context Protocol (MCP) server that integrates with VS Code and other compatible editors, providing a suite of tools for interacting with the GroundX platform to leverage its document understanding capabilities directly within a development environment.

How to use GXtract?

Install Python 3.12+, UV 0.7.6+, and clone the repository. Run uv sync to install dependencies. Configure your GroundX API key as an environment variable or via VS Code's secure inputs, then add a server entry in VS Code's settings.json under mcp.servers with the appropriate command and args. Reload VS Code to access the tools through MCP features.

Key features of GXtract

GroundX integration for document search, querying, and semantic object explanation.
MCP compliant for use with VS Code’s MCP client and compatible systems.
Built with Python 3.12+ and FastMCP v2 for performance.
Simple setup via VS Code settings configuration.
In-memory cache for GroundX metadata to reduce API calls.

Use cases of GXtract

Searching documents within your GroundX projects.
Asking specific questions about a document in GroundX.
Getting explanations for diagrams, tables, or other semantic objects within documents.
Manually refreshing the GroundX metadata cache when needed.

Frequently asked questions

What are the prerequisites for using GXtract?

You need Python 3.12 or higher, UV version 0.7.6 or higher, and a valid GroundX API key from the GroundX Dashboard.

How do I configure GXtract in VS Code?

Clone the repository, run `uv sync`, set your `GROUNDX_API_KEY` environment variable, then add a server entry in VS Code’s `settings.json` under `mcp.servers` with `command: "uv"`, appropriate `args` pointing to the project directory, and the transport set to `stdio`. Reload VS Code after saving.

How can I securely provide my GroundX API key?

You can set it as a system environment variable (`GROUNDX_API_KEY`) and reference it in VS Code settings with `${env:GROUNDX_API_KEY}`, or use VS Code’s secure inputs feature to prompt and store the key in your system’s credential manager. Avoid storing the key in plaintext in `settings.json`.

What transport types does GXtract support?

GXtract supports both `stdio` and `http` transport. VS Code currently only supports `stdio`. The transport can be set via the `--transport` argument or in the `args` array in VS Code settings.

How do I refresh the metadata cache?

Use the tool `cache/refreshMetadataCache` or `cache/refreshCachedResources` provided by the server. You can also disable caching entirely with the `--disable-cache` flag or adjust the cache TTL using `--cache-ttl`.

Comments

More Other MCP servers

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K