MCP_websearch/.env.example at master · ForLegalAI/MCP_websearch · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# =============================================================================
# MCP Search Server Configuration - Example File
# =============================================================================
# Copy this file to .env and fill in your values:
#   cp .env.example .env
# =============================================================================

# Environment (development, production)
# - development: Loads .env file automatically using python-dotenv
# - production: Environment variables must be set externally (Docker, K8s, etc.)
ENVIRONMENT=development

# =============================================================================
# Transport Settings
# =============================================================================

# MCP transport protocol
# - http: Streamable HTTP (recommended for web services, supports concurrent requests)
# - stdio: Standard I/O (for local CLI tools and direct integrations)
# - sse: Server-Sent Events (legacy, deprecated)
MCP_TRANSPORT=http

# Host address to bind the server
# - 0.0.0.0: Listen on all network interfaces (required for Docker)
# - 127.0.0.1: Localhost only (more secure for local development)
MCP_HOST=0.0.0.0

# Port number for HTTP/SSE transport
MCP_PORT=8000

# =============================================================================
# Authentication
# =============================================================================

# API key for Bearer token authentication
# - If set, all requests must include header: Authorization: Bearer <api_key>
# - If empty, authentication is disabled (not recommended for production)
# - Generate a secure key, e.g.: python -c "import secrets; print(f'sk-{secrets.token_hex(16)}')"
MCP_API_KEY=

# =============================================================================
# FastMCP Settings
# =============================================================================

# Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
FASTMCP_LOG_LEVEL=INFO

# Hide detailed error information from clients (recommended for production)
# - true: Masks internal error details for security
# - false: Shows full error details (useful for debugging)
FASTMCP_MASK_ERROR_DETAILS=false

# Input validation mode for tool parameters
# - false: Flexible validation with type coercion (e.g., "10" -> 10 for int)
# - true: Strict JSON Schema validation, rejects type mismatches
FASTMCP_STRICT_INPUT_VALIDATION=false

# Include FastMCP metadata in component responses
# - true: Includes tags and FastMCP-specific metadata in responses
# - false: Cleaner responses without internal metadata
FASTMCP_INCLUDE_FASTMCP_META=false

# =============================================================================
# Duplicate Handling
# =============================================================================

# How to handle duplicate tool registrations (error, warn, replace)
ON_DUPLICATE_TOOLS=error

# How to handle duplicate resource registrations (error, warn, replace)
ON_DUPLICATE_RESOURCES=warn

# How to handle duplicate prompt registrations (error, warn, replace)
ON_DUPLICATE_PROMPTS=replace

# =============================================================================
# Serper.dev API (Required for search tools)
# =============================================================================

# API key for Serper.dev Google Search and Scrape APIs
# - Required for search_web and extract_webpage tools to function
# - Get your API key at: https://serper.dev/
# - Free tier includes 2,500 queries/month
# - Pricing: https://serper.dev/pricing
#
# Tools using this API:
# - search_web: Google web search (1 credit per search)
# - extract_webpage: Web page content extraction (2 credits per page)
SERPER_API_KEY=

# =============================================================================
# Content Extraction Limits
# =============================================================================

# Maximum number of characters to keep from extracted webpage content.
# Content exceeding this limit will be truncated with a notice.
# Default: 20000 (~5 pages of text). Set to 0 to disable truncation.
MAX_CONTENT_LENGTH=20000