Ace-Mcp-Go

Go-based MCP server that indexes code repositories and enables semantic code search via natural-language queries.

GitHub Stars

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "leon2012-ace-mcp-go": {
      "command": "./acemcp",
      "args": [
        "--web-port",
        "8080"
      ],
      "env": {
        "TOKEN": "your-token-here",
        "BASE_URL": "https://api.example.com",
        "BATCH_SIZE": "10",
        "LOG_MAX_FILES": "5",
        "TEXT_EXTENSIONS": ".go,.py,.js",
        "EXCLUDE_PATTERNS": ".venv,venv,node_modules",
        "MAX_LINES_PER_BLOB": "800",
        "AUTO_INDEX_ON_CHANGE": "false",
        "LOG_MAX_FILE_SIZE_MB": "1"
      }
    }
  }
}

Ace-Mcp-Go is a Go-based MCP server that indexes your codebase and enables semantic code search through the Model Context Protocol. It lets you query code context in natural language, returning relevant snippets and context to help you understand and work with large codebases more efficiently.

How to use

You interact with the server through an MCP client. Start the server in stdio mode to communicate over standard input and output, or use the optional Web UI to manage the server and view logs.

Typical usage patterns include starting the server in standard mode for integration with your development workflow, enabling the web UI for easier administration, and adjusting configuration to tailor indexing and search behavior to your project.

To search code context from a client, you trigger the MCP search behavior through the client’s tooling. The server will index the specified project (if needed or updated), perform a semantic query against the remote API, and return the most relevant code snippets with their context.

How to install

Prerequisites: Go 1.21 or newer, a Unix-like shell, and Git. Optional tools include a Web UI browser for the administrative interface.

From source and build options are provided. Follow these steps to install from source or use prebuilt binaries.

# Clone the repository
git clone https://github.com/Leon2012/Ace-Mcp-Go.git
cd Ace-Mcp-Go

# Build the executable
make build

# Optional: Install to GOPATH
make install

Additional notes

First run will automatically create a configuration file at the path ~/.acemcp/settings.toml. You must configure the BASE_URL and TOKEN for API access, along with indexing and logging preferences.

If you prefer to run a prebuilt binary, download the appropriate release from the Releases page and run it directly.

You can run in Web UI mode to access a browser-based management panel or run in standard mode to communicate with an MCP client over stdio. You can also enable a debug console for real-time logs.

Available tools

search_context

Tool to search code context by indexing and querying code blocks. It indexes the project, calls the semantic search API, and returns relevant code snippets with context.

Built by

VeilStrat

AI signals for GTM teams