MCP-Enabled Community Assistant 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.

Related MCP server: SkillSync MCP

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.