0 Fork 0

Files

T

Evan Hu 206169c1d7 docs: add README for every content directory

Each directory (agents, hands, integrations, plugins, providers,
scripts, skills) now has a README documenting its TOML format,
current contents, and contribution steps.

2026-03-21 02:24:22 +09:00

1.8 KiB

Raw Blame History

Integrations

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

Structure

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

Integration TOML Format

id = "service-id"                 # Must match filename (without .toml)
name = "Service Name"
description = "What this integration 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 Integrations (25)

Integration	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 Integration

Create integrations/<name>.toml
Ensure id matches the filename
Test the MCP server command locally
Run python scripts/validate.py
Submit a PR

See CONTRIBUTING.md for the full guide.

1.8 KiB Raw Blame History