About Discourse MCP Server
Discourse MCP Server is a Node.js service for users who need to search Discourse forum posts. It provides a single search tool that returns post objects.
Key features
- 01Search Discourse forum posts
- 02Return arrays of post objects
Use cases
- 01Find forum discussions by topic
- 02Collect relevant posts for further analysis
MCP support
The MCP server exposes a Discourse post-search tool to clients, accepting a query and returning post objects.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEDiscourse MCP Server
Node.js server implementing Model Context Protocol (MCP) for Discourse search operation.
Features
- Search Posts on a Discourse forum using MCP protocol.
API
Tools
- search_posts
- Search posts on a Discourse forum
- Input:
query(string) - Returns an array of post objects
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
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"
}
}
}
}
Build
Docker build:
docker build -t ashdev/discourse-mcp-server .
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.