dajet

This MCP server provides access to DaJet metadata and database structure for 1C:Enterprise 8. It exposes an HTTP API that lets you retrieve metadata object types, database names, database descriptions, and the structure of metadata objects. The server is designed to work with one or more 1C:Enterprise databases configured in the datasources.json file and exposes its API on the configured HTTP endpoint (default http://localhost:3000 when configured in appsettings). You can connect a client or IDE using the mcp.json snippet shown in the repository to register the server under Cursor or other MCP clients. Available tools include: get_metadata_type_names (list of supported metadata object types), get_database_names (list of accessible databases), get_database_description (description for a specific database), get_database_metadata (structure metadata for a database), and get_metadata_object (description of a specific metadata object by database, type and name).

Prerequisites:

• .NET 10 SDK (for the standalone Windows/Linux distribution) or use the Docker image provided by the project if you prefer containerized deployment.
• Access to the internet to download the distribution or Docker image.

Option A: Install and run the standalone .NET distribution

1. Install .NET 10 SDK from https://dotnet.microsoft.com/en-us/download/dotnet/10.0
2. Download the DaJet MCP Server distribution from the repository releases and extract to a working directory, e.g. C:\dajet-mcp-server
3. Open a terminal and navigate to the installation folder
4. Run the server: DaJet.Mcp.Server.exe

Option B: Run via Docker (recommended for quick start)

1. Ensure Docker is installed and running
2. Pull the image: docker pull zhichkin/dajet-mcp-server
3. Run the container (example): docker run --name dajet-mcp-server --user=root -it -p 5000:5000 zhichkin/dajet-mcp-server
4. The MCP server will start and listen on port 5000 inside the container; you can map it to your host as shown above.

Notes and tips:

• The server reads its HTTP endpoint and port from appsettings.json (default is http://localhost:3000 if not configured).
• datasources.json contains one or more 1C:Enterprise 8 databases. The server uses AI-agent access by database name to query data.
• You can add additional databases by updating datasources.json and restarting the server.
• Example mcp.json for client integration: { "mcpServers": { "dajet-mcp-server": { "url": "http://localhost:3000" } } }
• If you run with Docker, ensure port 5000 is accessible or map it to another port if needed. Check logs for any connection errors to databases.
• The available endpoints do not require authentication by default in the README; implement security as needed in your deployment.