Search Discourse Posts via MCP
A focused MCP server for searching posts on any Discourse forum by query, via Docker or npx.
Maintainer of this project? Claim this page to edit the listing.
1.0.2Add to Favorites
Why it matters
Integrate your AI with Discourse forums to enable searching posts through the Model Context Protocol. Access forum content programmatically for enhanced AI capabilities.
Outcomes
What it gets done
Connect to Discourse forums using API credentials.
Search posts based on user-defined queries.
Retrieve post data in a structured format.
Enable AI-driven access to Discourse content.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-discourse | bash Capabilities
Tools your agent gets
Search posts on a Discourse forum by query string and returns an array of post objects
Overview
Discourse MCP Server
This MCP server exposes a single search_posts tool for searching posts on a configured Discourse forum by keyword. Use it when an AI assistant needs to search a Discourse community's post history. It only searches - it doesn't create or manage forum content.
What it does
Discourse MCP Server is a Node.js MCP server with a single, focused purpose: searching posts on a Discourse forum. It exposes one tool, search_posts, which takes a query string and returns an array of matching post objects from the configured Discourse instance.
When to use - and when NOT to
Use this when you want an AI assistant to search a specific Discourse community's posts by keyword - for example, looking up prior discussion on a topic before asking a new question, or researching how a community has addressed an issue. It requires a Discourse API URL, API key, and username configured for the target forum; without those credentials it cannot connect. It only supports searching posts - it does not create posts, reply, or manage forum content.
Capabilities
search_posts(query: string)- searches posts on the configured Discourse forum and returns matching post objects
How to install
Via 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"]
}
}
}
Or via 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"
}
}
}
}
Required environment variables: DISCOURSE_API_URL, DISCOURSE_API_KEY, DISCOURSE_API_USERNAME.
Who it's for
Community managers, support teams, or developers who want an AI assistant to quickly search a Discourse forum's post history by keyword.
Source README
Discourse 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 .
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.