discourse

MCP server from AshDevFr/discourse-mcp-server

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio ashdevfr-discourse-mcp-server docker 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 \
  --env DISCOURSE_API_KEY="1234" \
  --env DISCOURSE_API_URL="https://try.discourse.org" \
  --env DISCOURSE_API_USERNAME="ash"

How to use

This MCP server implements a Discourse search capability accessible via the MCP protocol. It exposes a tool named search_posts which accepts a query string and returns an array of post objects from a Discourse forum. To use it, configure your MCP client (e.g., Claude Desktop) to point at the discourse MCP server. You can run the server using Docker as shown in the configuration, or via NPX if you prefer running directly from the npm package. When invoking search_posts, pass a search string in the query parameter to retrieve matching forum posts.

How to install

Prerequisites:

Docker installed and running (for the default configuration).
Optional: Node.js and npm if you prefer building/running locally instead of Docker.

Installation steps (Docker):

Ensure Docker is installed: follow https://docs.docker.com/get-dstarted/
Pull or build the image (if needed): docker pull ashdev/discourse-mcp-server
Run the container with required environment/configuration: docker 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

Installation steps (NPX/Node.js):

Install Node.js (>= 14) from https://nodejs.org/
Install the MCP server package globally or locally via npm (example): npm install -g @ashdev/discourse-mcp-server
Run via NPX (as shown in the README): npx -y @ashdev/discourse-mcp-server
Configure environment variables as needed for your Discourse instance (URL, API key, username).

Then configure your MCP client to connect to the running server.

Additional notes

Environment variables are used to connect to your Discourse instance. If you encounter authentication errors, double-check DISCOURSE_API_KEY and DISCOURSE_API_USERNAME. In Docker setups, you can pass these as -e arguments or via an .env file. The server exposes a single tool: search_posts, which returns matching post objects. If the Discourse instance is behind authentication, ensure proper API access and permissions. For local testing, the README uses try.discourse.org with a placeholder API key; replace these values with your own during production use.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.