brianluft/arcadia

Arcadia MCP Server

Workarounds and additional tools for Cursor users on Windows.

Features

• Bash command execution

  • MCP tools: run_bash_command, read_output
  • Avoids Cursor bug: run tool attempts to use xterm bracketed paste on Windows where that isn't supported.
  • Avoids Cursor bug: run tool sometimes hangs before actually starting the command.
  • Avoids Cursor bug: commands sometimes execute but never return control to the model.
  • Improves on Cursor by automatically paging command outputs. Paging avoids blowing out the model's context from an unexpected long command output.
  • Improves on Cursor by adding mandatory timeouts to all command executions.

• Image analysis with AI

  • MCP tool: read_image
  • Uses GPT-4o to analyze and describe images, transcribe text, and answer questions about visual content
  • Improves on Cursor by letting the agent autonomously read images on disk. Cursor's multimodal function requires you to manually add images as context.
  • Requires an OpenAI API key in config.jsonc.

• Database querying and exploration

  • MCP tools: list_database_connections, list_database_schemas, list_database_objects, describe_database_object, list_database_types, run_sql_command
  • Connect to SQL Server databases and SQLite files to explore schemas, list objects, and execute queries
  • All SQL commands run in transactions that automatically roll back, ensuring no accidental data modification
  • Supports both SQL Server (with Windows or SQL authentication) and SQLite databases
  • Automatic output paging prevents long query results from overwhelming the model's context
  • Configure SQL Server connections in config.jsonc under the connections section

• Real-time log monitoring

  • logs.bat tool for viewing active command execution logs. The logs don't appear "live" inside Cursor, so use this tool in a separate terminal window to view the logs as they happen.

Installation

Prerequisites

• Windows 10/11
• Cursor IDE
• Git for Windows (for Git Bash)

Setup Instructions

1. Download Arcadia: Download the latest arcadia.zip from our GitHub Releases.

2. Extract: Extract arcadia.zip to a folder of your choice (e.g., C:\Tools\arcadia\)

3. Configure Cursor: Follow the INSTALLING.html guide.

4. Verify Installation: Ask the model to verify the presence of Arcadia MCP tools.