Skip to content

README.md

Latest commit

 

History

History
84 lines (63 loc) · 3.07 KB

README.md

File metadata and controls

84 lines (63 loc) · 3.07 KB
Raw

MCP Server

This directory contains a read-only Python MCP server for browsing and checking the scripts in this repository.

Tools

  • list_scripts lists the available PowerShell, Python, and Bash files.
  • read_script reads a script using a path relative to scripts/.
  • search_scripts searches for text and returns matching lines.
  • describe_script returns metadata and a short preview.
  • validate_script checks syntax without executing the script.
  • list_documentation lists the Markdown documentation files.
  • read_documentation reads one Markdown file.
  • get_repository_summary returns script and documentation statistics.

Python validation uses the standard library parser. Bash and PowerShell validation use bash -n and the PowerShell parser when those programs are available in PATH.

Installation

From the repository root:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r .\scripts\python\requirements.txt

Run

python .\scripts\python\mcp_server.py

The Streamable HTTP endpoint is available at:

http://localhost:8000/mcp

To inspect the server:

npx -y @modelcontextprotocol/inspector

Connect the inspector to http://localhost:8000/mcp.

Codex Cost Router

codex_cost_router.py is an optional Windows-friendly wrapper for Codex CLI and a local LiteLLM OSS proxy. It can clean prompts, compress logs, estimate tokens, apply budgets, and route one-shot Codex tasks to codex-light, codex-default, codex-long, or codex-deep. The local LiteLLM config dispatches those aliases across OpenAI and Gemini while keeping API keys in environment variables. When HF_TOKEN is available, it can also route Hugging Face and multi-provider tasks through the codex-hf-cheap and codex-hf-fast LiteLLM aliases, or launch an optional cost-routing-hf Codex profile that points directly at the Hugging Face router. codex-qwen-local is available as a local Ollama fallback through qwen2.5-coder:3b. codex-routing-policy.yaml keeps the default provider rules and fallback order editable without changing Python code.

See README_Codex_Cost_Routing.md for setup, activation, LiteLLM configuration, and usage instructions.

To enter OpenAI, Gemini, or Hugging Face keys through a local page for one session, run Start-CodexKeySessionWeb.ps1 and open http://127.0.0.1:8787/. Keys are kept in memory for the LiteLLM subprocess and are not written to disk. Use Test-CodexLiteLLMDispatch.ps1 to verify the local proxy aliases, or add -Call -Model codex-hf-cheap after entering a provider key to make one minimal dispatch request.

LLM Review Tools

finance_bias_evaluator.py is a deterministic first-pass checker for finance security, fairness, auditability, and governance controls. See README_Finance_Bias_Evaluator.md.

llm_bias_multi_agent.py is a provider-agnostic multi-agent manager for reviewing and revising LLM answers without calling an LLM provider. See README_LLM_Bias_Multi_Agent.md.