MCP-DB-Client copilot-instructions.md

Project instructions for MCP-DB-Client, a framework that lets 1C:Enterprise business software expose tools and data through the Model Context Protocol. It describes the C++ network component, 1C business-logic module, and project conventions.

In plain words
What is it for?
Use it when modifying the C++ DLL, 1C modules, HTTP and JSON-RPC handling, MCP tools, resources, prompts, or related build configuration.
Why use it?
It gives coding agents the repository's architecture, build rules, data formats, and thread-safety conventions so changes fit the existing framework.

Instructions file for GitHub Copilot

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/ditrixnew/mcp-db-client/copilot-instructions
Clone the repo
git clone --depth 1 https://github.com/DitriXNew/MCP-DB-Client

Made for: GitHub Copilot.

Per session 1,010 This file is loaded in full into every session.
When invoked 1,010 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01010 $0.01010
Opus 5 $0.00505 $0.00505
Sonnet 5 $0.00202 $0.00202
Haiku 4.5 $0.00101 $0.00101

Measured 3d ago against content hash 068618270122, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

MCP-DB-Client copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/copilot-instructions.md · 93 lines

How it starts

The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.

http1c — MCP Server Framework for 1C:Enterprise

Project Overview

This is a framework for building Model Context Protocol (MCP) servers from 1C:Enterprise. It consists of two parts:

  • http-1c-dll/ — C++17 native DLL (1C Native API add-in) that handles MCP transport
  • http-1c-dp/ — Reference 1C data processor (BSL module) showing how to implement tools, resources, and prompts

The DLL handles protocol-level concerns (HTTP, JSON-RPC, sessions, security). The BSL module handles business logic (tool handlers, resource data, prompt generation).

Architecture

MCP Client ←→ Native DLL (C++ httplib) ←→ 1C:Enterprise (BSL via ExternalEvent)
  • POST /mcp — JSON-RPC MCP requests
  • GET /mcp — SSE notification stream
  • DELETE /mcp — Session termination

Key Conventions

C++ (http-1c-dll/src/)

  • Build: CMake + MSVC, NMake Makefiles, /MT static CRT, /utf-8
  • JSON: nlohmann/json (json.hpp)
  • HTTP: cpp-httplib (httplib.h)
  • 1C API: Native API headers in include/ (AddInDefBase.h, IMemoryManager.h, types.h, ComponentBase.h)
  • String conversion: MB2WCHAR() / WCHAR2MB() for UTF-8 ↔ UTF-16
  • Thread safety: Separate mutexes per resource (toolsMutex, resourcesMutex, sessionMutex, etc.)
  • Events to 1C: ExtEvent(u"HttpServer", u"EventName", data)
  • Method registration: AddProcedure() / AddFunction() / AddProperty() with EN/RU names
  • Version: Defined in version.h as VERSION_SEMVER

BSL (http-1c-dp/http1c/Forms/Form/Ext/Form/Module.bsl)

  • Client-side handlers are &AtClient procedures (no Async/Await)
  • Server calls for metadata/computation use &AtServer functions
  • Component configuration via synchronous property assignments: Component.PropertyName = Value
  • Component methods via BeginCalling<MethodName> with NotifyDescription callbacks
  • DO NOT use reserved 1C names as local variables (Catalogs, Documents, Metadata, etc.)
  • JSON: JSONReader/JSONWriter + ReadJSON()/WriteJSON()
  • Error pattern: Try/Except → SendToolError() / SendResourceError() / SendPromptError()
  • Tool definitions: NewTool(), AddToolParam(), AddToolAnnotations(), SetToolOutputSchema()
  • Resource definitions: Structure with uri, name, description, mimeType
  • Prompt definitions: Structure with name, description, arguments array

Read the full file on GitHub · 93 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 93 lines · 1,010 tokens per session scan A 068618270122

Subscribe to this mod's changes

MCP-DB-Client copilot-instructions.md is an instructions file published in the GitHub repository DitriXNew/MCP-DB-Client (36 stars, last pushed 2mo ago), licensed MIT. It adds 1,010 tokens to every session, about $0.0051 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.