MCP 服务器

findata-mcp

A Financial Data Quality and AI Inference Evaluation MCP server that provides tools for auditing, bias detection, model evaluation, outlier scoring, A/B testing, and KPI reporting.

README

findata-mcp

Financial Data Quality & AI Inference Evaluation MCP Server

A Model Context Protocol (MCP) server that exposes six production-grade tools for AI agents working with financial datasets — covering data quality auditing, bias detection, model inference evaluation, outlier scoring, A/B testing, and KPI reporting.

Built to mirror the core responsibilities of Citi's Data Services & AI platform.

Tools

Tool	Description
`audit_data_quality`	Audits completeness, consistency, and machine-readability of financial records. Returns a quality score and remediation actions.
`detect_bias`	Detects demographic/categorical bias by comparing approval rates or amounts across cohort groups. Returns disparity ratios and a bias risk label (LOW / MEDIUM / HIGH).
`evaluate_model_inference`	Computes precision, recall, F1, AUC, and a PASS/FAIL verdict against configurable enterprise thresholds.
`score_outliers`	Flags anomalous records using Z-score and IQR methods across numeric fields.
`run_ab_comparison`	Compares two model variants on the same dataset and recommends a winner based on F1.
`generate_kpi_report`	Generates a structured KPI report — latency (avg/p95), throughput (rps), error rate, and SLA adherence — formatted for senior stakeholder delivery.

Installation

git clone https://github.com/srikarmanikonda/findata-mcp.git
cd findata-mcp
npm install

Run

node src/index.js

The server communicates over stdio using the MCP protocol — connect it to any MCP-compatible client (Claude Desktop, ADK agent, etc.).

Test

npm test

All 13 tests pass across all 6 tools.

Claude Desktop / MCP Client Config

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "findata-mcp": {
      "command": "node",
      "args": ["/path/to/findata-mcp/src/index.js"]
    }
  }
}

Example Usage (via MCP client)

Audit data quality:

{
  "tool": "audit_data_quality",
  "records": [
    { "id": "R001", "loan_amount": 15000, "region": "Northeast", "approved": 1 },
    { "id": "R002", "loan_amount": null,  "region": "Southeast", "approved": 0 }
  ],
  "required_fields": ["id", "loan_amount", "region", "approved"],
  "numeric_fields": ["loan_amount"]
}

Detect bias:

{
  "tool": "detect_bias",
  "records": [...],
  "group_field": "region",
  "outcome_field": "approved",
  "outcome_type": "binary"
}

Evaluate model inference:

{
  "tool": "evaluate_model_inference",
  "predictions": [
    { "id": "R001", "predicted": 0.91, "actual": 1 },
    { "id": "R002", "predicted": 0.22, "actual": 0 }
  ],
  "threshold": 0.5,
  "min_precision": 0.75,
  "min_recall": 0.70
}