Discourse MCP Server

@AshDevFr

Repository

Basic information

About Discourse MCP Server

No overview available yet

#discourse#mcp #server #search #nodejs

Discourse MCP Server 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",
        "."
      ]
    }
  }
}

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.

Frequently asked questions

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.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one