Discourse Search

🚀 Discourse MCP Server

A Model Context Protocol (MCP) server implemented in Node.js for Discourse search operations.

🚀 Quick Start

This server enables search operations on Discourse forums using the MCP protocol.

✨ Features

• Search for posts on Discourse forums using the MCP protocol.

📚 Documentation

API

Tools

• search_posts
  • Search for posts on the Discourse forum.
  • Input: query (string)
  • Returns an array of post objects.

💻 Usage Examples

Using with Claude Desktop

Add the following content to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "discourse": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "DISCOURSE_API_URL=https://try.discourse.org",
        "-e", "DISCOURSE_API_KEY=1234",
        "-e", "DISCOURSE_API_USERNAME=ash",
        "ashdev/discourse-mcp-server"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "discourse": {
      "command": "npx",
      "args": [
        "-y",
        "@ashdev/discourse-mcp-server"
      ],
      "env": {
        "DISCOURSE_API_URL": "https://try.discourse.org",
        "DISCOURSE_API_KEY": "1234",
        "DISCOURSE_API_USERNAME": "ash" 
      }
    }
  }
}

📦 Installation

Docker Build

docker build -t ashdev/discourse-mcp-server .