Discourse

Discourse

An MCP server to search Discourse posts on a Discourse forum.

6
Stars
4
Forks
3
Releases

Overview

Discourse MCP Server is a Node.js application that implements the Model Context Protocol (MCP) to enable searching posts on a Discourse forum through a standardized MCP interface. It exposes a search_posts tool that takes a query string as input and returns an array of post objects that match the query. The server is designed for easy deployment via Docker or NPX, with documentation showing how to configure access to a Discourse instance using environment variables like DISCOURSE_API_URL, DISCOURSE_API_KEY, and DISCOURSE_API_USERNAME. Usage examples are provided for Claude Desktop integration, including claude_desktop_config.json configurations to connect to the MCP server. A sample Docker run and an NPX invocation illustrate practical deployment options. The repository includes a Docker build command to containerize the server. Overall, this MCP server provides a focused and interoperable means to search Discourse posts within MCP-enabled clients and workflows.

Details

Owner
AshDevFr
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

MCP-based Discourse search

Search Posts on a Discourse forum using the MCP protocol.

search_posts API

Tool to search posts with input: query (string) and return: array of post objects.

Docker deployment

Run the MCP server with Docker and configure DISCOURSE_API_URL, DISCOURSE_API_KEY, and DISCOURSE_API_USERNAME.

NPX deployment

Run via NPX with environment variables to configure the target Discourse instance.

Claude Desktop integration

Usage instructions for integrating the MCP server with Claude Desktop (claude_desktop_config.json).

Docker build

Docker build command provided to containerize the MCP server.

Audience

DevelopersIntegrate with Claude Desktop or MCP clients to search Discourse posts.
Discourse adminsEmbed into internal tooling to search forum posts using MCP.

Tags

MCPDiscoursesearchpostsnodejsAPIDockerNPXClaude Desktop