Discourse MCP Server

@AshDevFr

About Discourse MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "discourse-mcp-server": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "ashdev/discourse-mcp-server",
        "."
      ]
    }
  }
}

Tools

Search posts on a Discourse forum

Overview

What is Discourse MCP Server?

Discourse MCP Server is a Node.js server that implements the Model Context Protocol (MCP) for searching posts on a Discourse forum. It provides a single tool, search_posts, that accepts a query string and returns an array of post objects. It is designed for developers who want to integrate Discourse search capabilities into MCP-compatible clients like Claude Desktop.

How to use Discourse MCP Server?

Configure the server by adding it to claude_desktop_config.json using either a Docker image (ashdev/discourse-mcp-server) or the npx command (@ashdev/discourse-mcp-server). You must set three environment variables: DISCOURSE_API_URL (the Discourse forum URL), DISCOURSE_API_KEY (your API key), and DISCOURSE_API_USERNAME (the username for the API key). Once configured, the client will have access to the search_posts tool.

Key features of Discourse MCP Server

Search posts on any Discourse forum.
Single tool: search_posts with a query string.
Supports Docker and npx deployment.
Returns an array of post objects.

Use cases of Discourse MCP Server

Query a public Discourse forum for relevant posts using an LLM agent.
Integrate Discourse community knowledge into a Claude Desktop workflow.
Automate searching for support topics across multiple Discourse instances.

FAQ from Discourse MCP Server

What does the `search_posts` tool do?

It searches posts on a Discourse forum based on a user-provided query string and returns matching posts as objects.

What environment variables are required?

Three environment variables are needed: DISCOURSE_API_URL (the forum base URL), DISCOURSE_API_KEY (your API key), and DISCOURSE_API_USERNAME (the username associated with the key).

How do I install Discourse MCP Server?

Add it to your claude_desktop_config.json using either docker run with the image ashdev/discourse-mcp-server or npx with the package @ashdev/discourse-mcp-server.

Does the server require any runtime aside from Node.js?

The README does not specify any runtime dependencies beyond the provided Docker image or npx command, which resolve the Node.js runtime automatically.

What transport does the server use?

The README does not specify the transport protocol, but as an MCP server it communicates via standard I/O when launched through the client configuration.

Frequently asked questions