MMCPMarkets
QA

qy527145/acemcp

API development

This page was translated automatically. Technical details may differ from the original. View the original

807 stars 113 forks Quality 74 Trend 23Apache-2.0
Repository Install

A project that turns ACE (Augment Context Engine) into MCP

Overview

The configuration file is automatically created at the first runtime in ~/.acemcp/settings.toml, containing default values. - BATCH_SIZE: Number of files uploaded per batch (default: 10) - MAX_LINES_PER_BLOB: Maximum number of rows before large file splitting (default: 800) - BASE_URL: API endpoint URL - TOKEN: Authentication token - TEXT_EXTENSIONS: List of file extensions to index - EXCLUDE_PATTERNS: List of modes to exclude (supports wildcards such as *.pyc) You can also configure it as follows: - (highest priority): --base-url、--token - (update user profile) - (use ACEMCP_ prefix) Add the following to your MCP client configuration (e.g., Claude Desktop): - --base-url: Override BASE_URL configuration - --token: Override TOKEN configuration - --web-port: Enable the web management interface on the specified port (e.g., 8080) - : View and edit server configurations (BASE_URL, TOKEN, BATCH_SIZE, MAX_LINES_PER_BLOB, TEXT_EXTENSIONS) - : Real-time monitoring of server logs via WebSocket connection, with intelligent reconnect function - Exponential reconnect avoidance strategy (1 second → 1.5 seconds → 2.25 seconds ... Up to 30 seconds) - Up to 10 reconnection attempts to prevent infinite looping - Automatic reconnection during network failures - Reduced log noise (WebSocket connection logs at DEBUG level) - : Test and debug MCP tools directly from the web interface - Test search_context tool, enter project paths and queries - View formatted results and error messages Query-based search for relevant code context. This tool performs ** before searching, ensuring the results are always up to date. It executes ** in your codebase and returns formatted text fragments, showing the location of relevant code. - : Before each search, the tool automatically indexes only new or modified files, skipping unchanged files to improve efficiency - : You don't need to index items manually - Just search, the tool will automatically process indexes - : Search results reflect the current state of the codebase - : Automatically detects and handles multiple file encodings (UTF-8, GBK, GB2312, Latin-1) - : Automatically follows .gitignore mode when indexing items

Overview (machine translated)

Chinese Simplified | English

Acemcp

MCP servers for codebase indexing and semantic search.

Installation

Development and Installation

Configuration

The configuration file is automatically created at the first run, at ~/.acemcp/settings.toml, containing default values.

Edit ~/.acemcp/settings.toml to configure the following:

Configuration Options:

  • BATCH_SIZE: Number of files uploaded per batch (default: 10)
  • MAX_LINES_PER_BLOB: Maximum number of rows before splitting a large file (default: 800)
  • BASE_URL: API endpoint URL
  • TOKEN: Authentication token
  • TEXT_EXTENSIONS: List of file extensions to be indexed
  • EXCLUDE_PATTERNS: List of modes to exclude (supports wildcards such as *.pyc)

You can also configure it in the following ways:

  • Command Line Parameters (highest priority): --base-url, --token
  • Web Management Interface (Update user profiles)
  • Environment variables (use the ACEMCP_ prefix)

MCP Configuration

Add the following to your MCP client configuration (e.g., Claude Desktop):

Basic Configuration

Available Command-Line Parameters:

  • --base-url: Overrides BASE_URL configuration
  • --token: Override the TOKEN configuration
  • --web-port: Enable the Web management interface on a specified port (e.g., 8080)

Enable the configuration of the web management interface

To enable the Web management interface, add the --web-port parameter:

Then access the management interface: http://localhost:8888

Web Management Features:

  • Configuration Management: View and edit server configurations (BASE_URL, TOKEN, BATCH_SIZE, MAX_LINES_PER_BLOB, TEXT_EXTENSIONS)
  • Real-Time Logs: Real-time monitoring of server logs via WebSocket connection, featuring intelligent reconnection functionality
  • Exponential retreat reconnect strategy (1 second → 1.5 seconds → 2.25 seconds … Maximum 30 seconds)
  • Up to 10 reconnection attempts to prevent infinite loops
  • Automatic reconnection in case of network failure
  • Reduced log noise (WebSocket connection logs at DEBUG level)
  • Tool Debugger: Test and debug MCP tools directly from the web interface
  • Test the search_context tool, entering the project path and query
  • View formatted results and error messages

Tools

search_context

Query-based search for relevant code context. This tool automatically performs incremental indexing before searching, ensuring results are always up to date.

This page was translated automatically. Technical details may differ from the original.

Install

uvx acemcp
New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "acemcp": { "command": "uvx", "args": [ "acemcp" ] } } }