Ashdevfr Discourse MCP Server

🚀 Discourse MCP Server

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

🚀 Quick Start

The Discourse MCP Server is a Node.js-based implementation of the Model Context Protocol (MCP) server, designed for search operations on Discourse forums.

✨ 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)
  • Return: An array containing post objects.

💻 Usage Examples

Integration with Claude Desktop

Add the following content to your claude_desktop_config.json file:

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

Build with Docker

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