Community Bot

An MCP-powered Discord Bot that interfaces with the Gaia Skill Tree canonical registry (gaia.json).

Architecture

This package implements a modular client-server structure:

1. MCP Server (src/mcp-server.ts): Wraps /graph/gaia.json as a Model Context Protocol tool provider, exposing:
   • search_skills: Searches skills by name/description.
   • get_skill_by_name: Returns full metadata and evidence for a specific skill.
   • list_badges: Lists badge tiers and criteria.
   • verify_evidence: Audits/verifies evidence chains for a skill.
2. Discord Bot (src/discord-bot.ts): Acts as the MCP client, spawning the MCP server as a subprocess and mapping Discord slash commands (/gaia <subcommand>) to tool execution.

Getting Started

Local Setup

1. Copy .env.example to .env and fill in the variables:

   cp .env.example .env
   

   Required fields:

   • DISCORD_TOKEN: Your Discord Bot token.
   • DISCORD_CLIENT_ID: Your Discord application's client ID.
   • GAIA_GRAPH_URL: Optional (defaults to https://gaia.tiongson.co/graph/gaia.json).

2. Install dependencies:

   npm install
   

3. Build and compile:

   npm run build
   

4. Start the Discord bot:

   npm start
   

Docker Setup

You can build and deploy the bot containerized with Docker:

# Build & start container
docker compose up -d --build

Ensure that the .env file is present in this directory before running docker compose.