AshDevFr_discourse-mcp-server

The Discourse MCP Server is a Node.js-based server designed to facilitate search operations on a Discourse forum using the Model Context Protocol (MCP). This server allows users to perform efficient searches across forum posts by leveraging the MCP protocol, which is known for its structured and standardized approach to handling model context operations. The server can be deployed using Docker or NPX, making it versatile and easy to integrate into various environments. It is particularly useful for developers and administrators who need to implement search functionalities in their Discourse forums with minimal setup and configuration.

Features

• Search Posts on a Discourse forum using MCP protocol.

MCP Tools

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

Usage with Different Platforms

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" 
      }
    }
  }
}

Build

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