mcp-bitsight

A focused Model Context Protocol (MCP) server that exposes BitSight Security Ratings as tools for AI assistants.

Note: This repo will be renamed from mcp-gateway to mcp-bitsight to reflect its single purpose.

Architecture Context

This is one component in a larger MCP architecture:

┌─────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│    User     │────▶│  LLM Layer   │────▶│  MCP Gateway │────▶│ mcp-bitsight │ ← This repo
│  (Cursor)   │     │ (AI Foundry) │     │   (Router)   │     │              │
└─────────────┘     └──────────────┘     └──────┬───────┘     └──────────────┘
                                                │
                                                ├────▶ mcp-servicenow (future)
                                                └────▶ mcp-* (future)

Available Tools

Quick Start

1. Clone and Setup

git clone https://github.com/your-org/mcp-bitsight.git
cd mcp-bitsight

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e .

2. Configure Environment

Create a .env file:

BITSIGHT_API_TOKEN=your-api-key-here
LOG_LEVEL=WARNING

3. Connect to Cursor

Add to ~/.cursor/mcp.json (macOS/Linux) or %USERPROFILE%\.cursor\mcp.json (Windows):

{
  "mcpServers": {
    "bitsight": {
      "command": "/full/path/to/mcp-bitsight/venv/bin/python",
      "args": ["/full/path/to/mcp-bitsight/main.py"],
      "cwd": "/full/path/to/mcp-bitsight"
    }
  }
}

4. Restart Cursor

After updating mcp.json, restart Cursor completely (Cmd+Q / Alt+F4, then reopen).

Corporate Proxy / SSL Certificates

If behind a corporate firewall that intercepts HTTPS, place CA certificates in certs/:

certs/
├── combined_ca_bundle.pem
└── ca_bundle.pem

Or set via environment:

MCP_CA_BUNDLE=/path/to/your/ca_bundle.pem

Cloud Deployment (Azure)

CI/CD

Push to dev branch triggers automatic build and deploy via GitHub Actions.

Required GitHub Secrets:

Connect Cursor to Cloud

{
  "mcpServers": {
    "bitsight": {
      "url": "https://your-app.azurecontainerapps.io/sse"
    }
  }
}

Project Structure

mcp-bitsight/
├── app/
│   ├── __init__.py
│   ├── bitsight.py      # BitSight API client
│   └── server.py        # MCP tools
├── certs/               # SSL certificates
├── Documentation/
├── .github/workflows/   # CI/CD
├── main.py              # Entry point
├── pyproject.toml       # Dependencies
└── Dockerfile

Environment Variables

Development

pip install -e ".[dev]"
pytest
ruff check .
ruff format .

License

MIT