feat(mcp):added MCP server (#97)

* docs(specs): design research-agent MCP tools and ktx mcp daemon

Adds the 2026-05-14 design spec for exposing four new MCP tools
(discover_data, entity_details, dictionary_search, sql_execution),
shipping a ktx-research skill, and introducing an HTTP-only ktx mcp
daemon so external agents can use KTX as a research-capable context
layer.

* Refine research-agent MCP tools spec after adversarial review iteration 1

* Refine research-agent MCP tools spec after adversarial review iteration 2

* Refine research-agent MCP tools spec after adversarial review iteration 3

* Refine spec: drop connectionName compat carve-out and ground summary/snippet provenance per kind

* feat(daemon): validate read-only SQL with sqlglot

* feat(context): expose read-only SQL validation port

* feat(context): register MCP sql execution tool

* feat(context): execute MCP SQL through validated connector path

* test(context): update SQL analysis port fixtures

* docs: add research-agent MCP sql execution foundation plan

* feat(context): add scan-backed entity details service

* feat(context): register MCP entity details tool

* feat(context): expose local MCP entity details

* test(context): align entity details scan fixtures

* docs: add research-agent MCP entity_details plan

* feat(context): add dictionary search service

* feat(context): register MCP dictionary search tool

* feat(context): expose local MCP dictionary search

* docs: add research-agent MCP dictionary_search plan

* feat: add MCP discover data service

* feat: expose discover data MCP tool

* feat: wire local discover data MCP port

* docs: add research-agent MCP discover_data plan

* feat(cli): add mcp http security helpers

* feat(cli): host mcp over streamable http

* feat(cli): manage mcp daemon lifecycle

* feat(cli): add ktx mcp commands

* fix(cli): stabilize mcp daemon verification

* docs: add research-agent MCP http daemon plan

* feat(cli): install KTX research skill

* feat(cli): configure MCP clients in setup agents

* feat(cli): support Claude local MCP setup scope

* docs: add research-agent MCP setup-agents plan

* refactor(context): use connectionId in warehouse verification tools

* docs(context): update ingest verification prompts for connectionId

* docs: add research-agent MCP ingest contract convergence plan

* chore: build runtime artifacts in conductor setup

---------

Co-authored-by: Andrey Avtomonov <7889985+andreybavt@users.noreply.github.com>

packages/context/src/ingest/adapters/historic-sql/historic-sql.adapter.test.ts

@@ -18,6 +18,9 @@ const sqlAnalysis: SqlAnalysisPort = {
   async analyzeBatch() {
     return new Map();
   },
+  async validateReadOnly() {
+    return { ok: true };
+  },
 };
 
 const reader: HistoricSqlReader = {
@@ -79,6 +82,9 @@ describe('HistoricSqlSourceAdapter', () => {
           ],
         ]);
       },
+      async validateReadOnly() {
+        return { ok: true };
+      },
     };
     const adapter = new HistoricSqlSourceAdapter({
       sqlAnalysis: batchSqlAnalysis,

packages/context/src/ingest/adapters/historic-sql/local-ingest-acceptance.test.ts

@@ -159,6 +159,7 @@ function acceptanceSqlAnalysis(): SqlAnalysisPort {
         );
       },
     ),
+    validateReadOnly: vi.fn(async () => ({ ok: true })),
   };
 }
 

packages/context/src/ingest/adapters/historic-sql/stage-unified.test.ts

@@ -83,6 +83,7 @@ describe('stageHistoricSqlAggregatedSnapshot', () => {
         ],
         ['bad-parse', { tablesTouched: [], columnsByClause: {}, error: 'parse failed' }],
       ])),
+      validateReadOnly: vi.fn(async () => ({ ok: true })),
     };
 
     await stageHistoricSqlAggregatedSnapshot({
@@ -207,6 +208,7 @@ describe('stageHistoricSqlAggregatedSnapshot', () => {
           },
         ],
       ])),
+      validateReadOnly: vi.fn(async () => ({ ok: true })),
     };
 
     await stageHistoricSqlAggregatedSnapshot({
@@ -283,6 +285,7 @@ describe('stageHistoricSqlAggregatedSnapshot', () => {
           },
         ],
       ])),
+      validateReadOnly: vi.fn(async () => ({ ok: true })),
     };
 
     await stageHistoricSqlAggregatedSnapshot({
@@ -403,6 +406,7 @@ describe('stageHistoricSqlAggregatedSnapshot', () => {
           },
         ],
       ])),
+      validateReadOnly: vi.fn(async () => ({ ok: true })),
     };
 
     await stageHistoricSqlAggregatedSnapshot({