Gxtract MCP Server

@sascharo

代码仓库主页

基本信息

分类

其他

许可证

NOASSERTION

传输方式

stdio

作者

sascharo

提交者

Sascha Robitzki

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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 工具

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).

概览

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.

常见问题

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`.

其他分类下的更多 MCP 服务器

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

der die das – German noun genders (Lingviko)

Lingviko

The article (der, die, das) of 90,000 German nouns, compounds included, plus a checker that finds wrong articles in German text (“mit der Zug” → dem). Uses dictionary data, not AI guessing. Free, no login.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

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