@connorbritain/msql-mcp-core (英语)

MSSQL MCP分级包家族共享核心库. 这个软件包提供每个工具类,MCP服务器的利用,环境管理,审计记录,秘密解析,意图路由,以及政策执行中间软件. 消费者软件包(阅读器、作家、服务器)依赖于此库和呼叫 startMcpServer() 带有一个级,以获得一个配置齐全的MCP服务器.

建筑

@connorbritain/mssql-mcp-core
        |
        |-- @connorbritain/mssql-mcp-reader  (14 read-only tools)
        |-- @connorbritain/mssql-mcp-writer  (17 tools: reader + INSERT/UPDATE/DELETE)
        |-- @connorbritain/mssql-mcp-server  (20 tools: writer + CREATE TABLE/INDEX, DROP TABLE)

每一个消费者包件都是薄薄的包装纸,通过它的分层 startMcpServer()所有业务逻辑、工具实施和治理基础设施都在这里.

消费者软件包如何使用此库

import { startMcpServer } from "@connorbritain/mssql-mcp-core";

startMcpServer({ tier: "reader" });

这个 tier 参数控制在 MCP 服务器上注册的工具 :

配置构建器 ——视觉向导为消费者包生成配置文件.

出口

服务器入口

import { startMcpServer } from "@connorbritain/mssql-mcp-core";

• startMcpServer(config: McpServerConfig) ——初始化 MCP 服务器为给定等级的 stdio. 注册工具,应用 wrapToolRun 策略中间软件,然后开始听.

工具类

所有20个工具类别都单独导出:

import {
  // Read-only (Reader tier)
  ReadDataTool,
  ListTableTool,
  ListDatabasesTool,
  ListEnvironmentsTool,
  ValidateEnvironmentConfigTool,
  ListScriptsTool,
  RunScriptTool,
  DescribeTableTool,
  SearchSchemaTool,
  ProfileTableTool,
  RelationshipInspectorTool,
  InspectDependenciesTool,
  TestConnectionTool,
  ExplainQueryTool,

  // Write (Writer tier adds these)
  InsertDataTool,
  DeleteDataTool,
  UpdateDataTool,

  // Admin/DDL (Server tier adds these)
  CreateTableTool,
  CreateIndexTool,
  DropTableTool,
} from "@connorbritain/mssql-mcp-core";

每个工具类执行 RunnableTool 接口 name, (中文(简体) ), description, (中文(简体) ), inputSchema,以及 run(params)。 。 。 .

环境管理

import { EnvironmentManager, getEnvironmentManager } from "@connorbritain/mssql-mcp-core";

• EnvironmentManager ——管理多环境配置,连接池,每个环境政策(只读,允许的Tools,拒绝的Tools,最大RowsDefault,需要的Approval,审计级,允许的Schemas,拒绝的Schemas,允许的Columns,拒绝的Columns),以及秘密解析.
• getEnvironmentManager() ——返回单子实例.

审计日志

import { AuditLogger, auditLogger } from "@connorbritain/mssql-mcp-core";

• AuditLogger ——将JSON行的审计日志条目写入时间戳,工具名,参数(敏感字段自动编辑),结果,会话ID,以及环境名.
• auditLogger - Singleton的例子。 通过配置 AUDIT_LOG_PATH 财务报告和审定财务报表 AUDIT_LOGGING 环境变量.

秘密解析

import {
  SecretResolver,
  createSecretResolver,
  validateDotenvPath,
  validateFileDirectory,
} from "@connorbritain/mssql-mcp-core";

• SecretResolver - 决定 ${secret:NAME} 环境变量配置值中的占位符, .env 文件,或外部秘密提供者.
• createSecretResolver(config) - 工厂 SecretResolver 实例.

有意路线

import { IntentRouter } from "@connorbritain/mssql-mcp-core";

• IntentRouter ——用关键词匹配和打分的方式将自然语言意图通向适当的MCP工具. 内部使用 startMcpServer。 。 。 .

策略中间软件

import { wrapToolRun } from "@connorbritain/mssql-mcp-core";

• wrapToolRun(tool, options) - 猴子拍出一个工具 run() 执行每个环境政策的方法(只读、允许Tools、拒绝使用Tools、需要Approval),获得连接池,在工具参数中输入环境上下文,并将所有引用记录到审计日志.

工具夹帮助工具

import {
  createAllToolInstances,
  getReaderTools,
  getWriterTools,
  getAdminTools,
  buildToolRegistry,
  READER_MUTATING_TOOLS,
  WRITER_MUTATING_TOOLS,
  ADMIN_MUTATING_TOOLS,
  READER_APPROVAL_EXEMPT,
  WRITER_APPROVAL_EXEMPT,
  ADMIN_APPROVAL_EXEMPT,
} from "@connorbritain/mssql-mcp-core";

• createAllToolInstances() ——将全部20个工具类进行校正,并作为被命名的对象返回.
• getReaderTools(t) ——返回阅读层的14个工具阵列.
• getWriterTools(t) ——返回写入层的17个工具阵列.
• getAdminTools(t) 返回管理员/服务器级的20个工具阵列.
• buildToolRegistry(t) ——返回全程配置数组 IntentRouter。 。 。 .
• READER_MUTATING_TOOLS - 空的 Set<string> (阅读器没有变异工具).
• WRITER_MUTATING_TOOLS —— 说 Set 联 合 国 insert_data, (中文(简体) ), delete_data, (中文(简体) ), update_data。 。 。 .
• ADMIN_MUTATING_TOOLS —— 说 Set 所有写入 + DDL 工具名称.
• READER_APPROVAL_EXEMPT —— 说 Set 绕行工具 requireApproval 在阅读层.
• WRITER_APPROVAL_EXEMPT —— 说 Set 绕行工具 requireApproval 在写作层.
• ADMIN_APPROVAL_EXEMPT —— 说 Set 绕行工具 requireApproval 在行政级别.

类型

import type {
  TierLevel,
  McpServerConfig,
  IntentCategory,
  RunnableTool,
  ToolRoutingConfig,
  IntentRouterOptions,
  RoutingCandidate,
  RouteParams,
  RouteResult,
  WrapToolRunOptions,
  EnvironmentConfig,
  EnvironmentsConfig,
  AccessLevel,
  AuditLogEntry,
  AuditLevel,
  SecretsConfig,
  SecretProviderConfig,
} from "@connorbritain/mssql-mcp-core";

构建

npm install
npm run build   # Compiles TypeScript to dist/
npm run watch   # Watch mode for development

相关软件包

许可证

麻省理工学院