What is Arcadia

Arcadia MCP Server is a tool designed to provide workarounds for various bugs encountered with the Cursor IDE on Windows. It facilitates better command execution and image analysis capabilities using AI, thereby enhancing the user experience.

Use cases

Users can utilize Arcadia MCP for executing bash commands more reliably on Windows, overcoming Cursor’s limitations, and for analyzing images with the aid of AI. These features are particularly beneficial for developers and data analysts who require efficient tools for command execution and visual content interpretation.

How to use

To use Arcadia MCP, one needs to download and extract the arcadia.zip package, configure it within the Cursor IDE following the INSTALLING.html guide, and verify its installation through specific commands to check the presence of MCP tools.

Key features

Arcadia MCP includes features such as bash command execution with improved reliability and timeouts, auto-paging of command outputs, and the capability for AI-driven image processing. It also allows autonomous access to image analysis without manual context addition.

Where to use

Arcadia MCP is intended for use on Windows 10 or 11 systems in conjunction with the Cursor IDE, particularly in environments where command execution and image analysis are essential, such as software development, automation scripts, and data analysis tasks.

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.