Files
reverse-engineering-anything/tests/fixtures/debuggerMcp.ts
T
morluto e94ca9f223 refactor(mcp): bind GDB and Cutter tools under external-mutation admission through the shared table (#11637)
* refactor(mcp): bind GDB and Cutter tools under external-mutation admission through the shared table

GDB start and status, and Cutter discovery, bind as values outside admission; gdb_console and cutter_command bind on the external-mutation evidence kind (gdb_console with delivery detail), and close_gdb_session on owned-cleanup. Tests build their servers through one debugger fixture, and the Rizin lifecycle regressions now run for all three debuggers.

* refactor(mcp): bind the session target, context and process capture tools through the shared table (#11640)

Value bindings can return a ReducibleValue (alternatives tried when the complete value overflows) or a DetailedFailure (facts delivered beside the error's details). A new query binding reads the analysis its required admission grants. open_binary and open_bundle_resources bind as values; get_navigation_context and inspect_address_context as queries; capture_process_scenario on the analyze kind through an application owner that records its Evidence and residual unknowns.
2026-11-16 09:28:35 +08:00

74 lines
2.5 KiB
TypeScript

import type { EvidenceLookup } from "../../src/application/EvidenceInputResolver.js";
import { silentLogger } from "../../src/logger.js";
import { EvidenceMcpServer } from "../../src/server/EvidenceMcpServer.js";
import type { ExternalMutationAdmission } from "../../src/server/externalMutationAdmission.js";
import {
registerServiceTools,
type CutterToolOptions,
type GdbToolOptions,
type RizinDebugToolOptions,
type ToolServices,
} from "../../src/server/serviceToolBindings.js";
import { createToolResultDelivery } from "../../src/server/toolResult.js";
type RecordEvidence = ConstructorParameters<typeof EvidenceMcpServer>[2];
/** Session-ledger dependencies a debugger server records into and reads. */
export interface DebuggerMcpLedger {
readonly recordEvidence?: RecordEvidence;
readonly evidenceById?: EvidenceLookup;
/** Response budget; the delivery default when omitted. */
readonly maxResponseBytes?: number;
}
/** An MCP server binding only the given debugger services from the shared table. */
const debuggerMcpServer = (
name: string,
services: Partial<ToolServices>,
{ recordEvidence, evidenceById, maxResponseBytes }: DebuggerMcpLedger,
): EvidenceMcpServer => {
const server = new EvidenceMcpServer(
{ name, version: "1" },
{},
recordEvidence,
createToolResultDelivery(maxResponseBytes),
);
registerServiceTools(server, services, {
logger: silentLogger,
recordEvidence,
evidenceById,
});
return server;
};
/** An MCP server binding only the Rizin debugger tools over `manager`. */
export const rizinDebugMcpServer = (
name: string,
manager: RizinDebugToolOptions["manager"],
session?: ExternalMutationAdmission,
recordEvidence?: RecordEvidence,
): EvidenceMcpServer =>
debuggerMcpServer(
name,
{ rizinDebug: { manager, session } },
{ recordEvidence },
);
/** An MCP server binding only the GDB session tools over `manager`. */
export const gdbMcpServer = (
name: string,
manager: GdbToolOptions["manager"],
session?: ExternalMutationAdmission,
ledger: DebuggerMcpLedger = {},
): EvidenceMcpServer =>
debuggerMcpServer(name, { gdb: { manager, session } }, ledger);
/** An MCP server binding only the Cutter tools over `service`. */
export const cutterMcpServer = (
name: string,
service: CutterToolOptions["service"],
session?: ExternalMutationAdmission,
recordEvidence?: RecordEvidence,
): EvidenceMcpServer =>
debuggerMcpServer(name, { cutter: { service, session } }, { recordEvidence });