librefang-registry/mcp/README.md

MCP Servers

MCP (Model Context Protocol) server templates for LibreFang. Each entry connects LibreFang to an external service (GitHub, Slack, databases, etc.).

Structure

mcp/
├── github.toml
├── slack.toml
├── postgresql.toml
└── ...

MCP Server TOML Format

id = "service-id"                 # Must match filename (without .toml)
name = "Service Name"
description = "What this MCP server provides"
category = "devtools"             # devtools | communication | storage | monitoring | data
icon = "🐙"
tags = ["relevant", "tags"]

[transport]                       # MCP server transport config
type = "stdio"                    # "stdio" or "sse"
command = "npx"
args = ["-y", "@pkg/mcp-server"]

[[required_env]]                  # Required environment variables
name = "SERVICE_API_KEY"
label = "API Key"
help = "How to obtain this key"
is_secret = true
get_url = "https://..."

[oauth]                           # Optional: OAuth config
provider = "github"
scopes = ["repo"]
auth_url = "https://..."
token_url = "https://..."

[health_check]
interval_secs = 60
unhealthy_threshold = 3

setup_instructions = """
Step-by-step setup guide for users.
"""

Current MCP Servers (25)

MCP Server	Category	Service
github	devtools	GitHub repos, issues, PRs
slack	communication	Slack messaging
notion	productivity	Notion pages and databases
postgresql	storage	PostgreSQL database
...		See each file for details

Adding a New MCP Server

1. Create mcp/<name>.toml
2. Ensure id matches the filename
3. Test the MCP server command locally
4. Run python scripts/validate.py
5. Submit a PR

See CONTRIBUTING.md for the full guide.