EdgarTools MCP Server - Docker

Docker wrapper for the EdgarTools Model Context Protocol (MCP) server.

Quick Start

Build the Image

./publish_to_docker.sh

This will:

1. Build the Docker image
2. Optionally push to Docker Hub (hackerdogs/edgartools-mcp)

Run Locally

# Build the image
docker build -t edgartools-mcp .

# Run the MCP server
docker run -i --rm edgartools-mcp

Use in MCP Client Configuration

Quick Setup:

1. See MCP_CONFIGURATION.md for complete setup guide
2. Use the ready-made config files in this directory:
   • mcp-config-docker.json - For Docker deployment
   • mcp-config-claude-desktop-macos.json - For Claude Desktop on macOS
   • mcp-config-claude-desktop-windows.json - For Claude Desktop on Windows
   • mcp-config-cline-vscode.json - For Cline VS Code extension
   • mcp-config-continue-dev.json - For Continue.dev

Docker Configuration Example:

{
  "mcpServers": {
    "edgartools": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "hackerdogs/edgartools-mcp:latest"],
      "env": {
        "EDGAR_IDENTITY": "Your Name your.email@example.com"
      }
    }
  }
}

Important: Update EDGAR_IDENTITY with your actual name and email in all configuration files.

Environment Variables

• EDGAR_IDENTITY (required): Your SEC identity in format "Your Name your.email@example.com"
  • Required by the SEC for API requests
  • Can be set in MCP client configuration or via Docker -e flag

Publishing

The publish_to_docker.sh script handles building and publishing:

./publish_to_docker.sh

The script will:

• Build the image with version tag and latest tag
• Prompt for confirmation before pushing
• Push to hackerdogs/edgartools-mcp on Docker Hub

Image Details

• Base Image: python:3.11-slim
• Package: edgartools[ai] (includes MCP dependencies)
• Entry Point: python -m edgar.ai
• Transport: stdio (stdin/stdout) - no ports exposed

Local Development

To test locally with the venv:

# Activate venv
source venv/bin/activate

# Test the server
python -m edgar.ai --test

# Run the server
python -m edgar.ai

Requirements

• Docker installed and running
• Docker Hub account (for publishing)
• EDGAR_IDENTITY environment variable set (for SEC API access)