README.md•2.27 kB
# MCPolice 🔒
International AI Compliance Monitoring System for tracking violations of international laws by AI tools.
## Overview
MCPolice is a sleek web application designed for international agencies (Interpol, IAEA, UN, etc.) to monitor and track violations of international laws reported by AI tools via the MCP (Model Context Protocol) protocol.
## Quick Start
```bash
# Install dependencies
npm install
# Start the web server with server
npm run dev
# The web dashboard will be available at http://localhost:5173
# The MCP server will be available at http://localhost:5173/mcp
# MCP endpoints: /tools/list and /tools/call
```
## MCP Integration
MCPolice implements the [Model Context Protocol](https://modelcontextprotocol.io/) via HTTP transport.
### MCP Endpoints:
- **`GET /tools/list`** - List available MCP tools
- **`POST /tools/call`** - Execute MCP tool calls
### Available MCP Tools:
- **`report_violation`** - Report a violation of international law
- **`list_statutes`** - Get available international law statutes
- **`get_violation_stats`** - Get violation statistics
- **`list_violations`** - List recent violations with filtering
### Testing MCP Tools:
```bash
# List available tools
curl http://localhost:5173/mcp/tools/list
# Get available statutes
curl -X POST http://localhost:5173/mcp/tools/call \
-H "Content-Type: application/json" \
-d '{"name": "list_statutes", "arguments": {}}'
# Report a violation
curl -X POST http://localhost:5173/mcp/tools/call \
-H "Content-Type: application/json" \
-d '{
"name": "report_violation",
"arguments": {
"statute": "Rome Statute Article 7",
"responsible_organization": "TestAI",
"offending_content": "Test violation content"
}
}'
```
## Production Deployment
```bash
# Create KV namespaces (first time only)
npx wrangler kv:namespace create "VIOLATIONS_KV"
npx wrangler kv:namespace create "VIOLATIONS_KV" --preview
# Update wrangler.jsonc with the returned namespace IDs
# Build and deploy
npm run deploy
```
## Architecture
MCPolice consists of two main components:
1. **MCP Server** (`src/mcp-server.ts`) - Handles violation reporting via MCP protocol
2. **Web Dashboard** (`src/index.tsx`) - Provides monitoring interface for agencies