mcbp-ai — MCP server for BAS / 1C (MCBP+)

Read your BAS (1C) database from any MCP client. Catalogs, documents, register balances and records, and the full configuration metadata tree — exposed as MCP tools over the MCBP_AI HTTP service.

Read-only by default. None of the tools available out of the box modifies your data.

Model-agnostic. MCP is a vendor-neutral standard, so this server works with Claude Desktop / Code, ChatGPT desktop, Gemini, Microsoft and GitHub Copilot, Cursor, Windsurf, VS Code and Zed — it serves tools/list and executes tools/call without knowing which model is asking. The transport is stdio, so the client launches the process locally; browser-based clients would need a remote HTTP server, which this one does not expose.

⚠ This server needs a server-side component that is not in this repository

mcbp-ai is a client for the MCBP_AI HTTP service — a BSL module (a common module plus an HTTP service definition) that must be installed into your BAS/1C configuration through Конфігуратор. That module is licensed separately and is not part of this repository.

Without it this server starts, connects, and every route answers 404. If you want to run it against your own base, contact MCBP.PLUS to obtain the MCBP_AI module.

The Python code here — the MCP adapter and the shared BAS client — is open source and complete.

The MCBP+ configuration and the MCBP_AI service module are proprietary works of MCBP.PLUS and are distributed separately from this repository. This MIT licence covers the Python packages only.

Why this exists

BAS/1C holds the data, but it is not reachable from an LLM: the platform speaks its own query language, metadata names are inherited Russian identifiers while synonyms are Ukrainian, and a raw OData feed is both heavy and hostile to a model (opaque errors, no self-correction path).

MCBP_AI solves that on the BAS side — canonical English field names in list rows, compact responses, and errors that name the offending field verbatim so a model can fix its own call. This server is the thin MCP adapter in front of it.

Tools

10 read tools are always registered. Three write tools appear only when MCP_ALLOW_WRITE is on.

The model is expected to walk list_metadata → describe_metadata → search/filter → get_object. Errors are deliberately not swallowed: an unknown field comes back as BAD_PARAMETER naming that field, which is how the model corrects itself.

Install

Requires Python 3.11+.

pip install mcbp

Configure

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "mcbp-ai": {
      "command": "python",
      "args": ["-m", "mcbp_mcp_server"],
      "env": {
        "ONEC_BASE_URL": "http://host/base/hs/mcbp_ai",
        "ONEC_USER": "ai_service",
        "ONEC_PASSWORD": "***"
      }
    }
  }
}

Claude Code

claude mcp add mcbp-ai --env ONEC_BASE_URL=http://host/base/hs/mcbp_ai \
                       --env ONEC_USER=ai_service \
                       --env ONEC_PASSWORD=*** \
                       -- python -m mcbp_mcp_server

Environment

ONEC_BASE_URL — leave off the /ai/v1

The client appends /ai/v1/... itself, so the base URL stops at the service name:

http://localhost/mybase/hs/mcbp_ai          ← correct
http://localhost/mybase/hs/mcbp_ai/ai/v1/   ← also accepted (normalized away)

Note that the published path genuinely repeats the segment: rootUrl is mcbp_ai in default.vrd, and the service's own URL templates start with ai/v1.

Security

• Read-only unless you deliberately set MCP_ALLOW_WRITE=1. The write tools are not merely hidden — they are never registered, so they cannot be invoked.
• Credentials live only in the MCP client's env block; nothing is written to disk by this server.
• The BAS side adds its own checks: the publication's user rights, plus an infobase-key check. If the key does not match, health reports key: false and every other route answers 403 KEY_MISMATCH.
• write_object additionally requires the MCBP Plus extension and a configured conversion rule; without one it returns 422 CONVERSION_NOT_CONFIGURED and writes nothing.

Troubleshooting

License

See LICENSE.