MCP ExplorerExplorer

Discourse

@AshDevFron 13 days ago
4 MIT
FreeCommunity
Web Services
#discourse#search
A MCP server to search Discourse posts on a Discourse forum.

Overview

What is Discourse

The Discourse MCP Server is a Node.js application that implements the Model Context Protocol (MCP) to facilitate search operations within Discourse forums. It allows users to perform search queries on posts using an API that connects to a Discourse forum’s API.

Use cases

This server is useful for developers looking to integrate Discourse forum capabilities into their applications, enabling them to search for posts programmatically. It can be utilized in a variety of applications, including chatbots, custom dashboards, and larger systems that require interaction with Discourse data.

How to use

To use the Discourse MCP Server, one can set it up as a Docker container or run it via npx. Configuration involves specifying the Discourse API URL, API key, and username, which allows the server to authenticate and perform search functions against the Discourse forum.

Key features

The main feature of the Discourse MCP Server is its ability to search posts in a Discourse forum using the MCP protocol. It supports a simple API interface that returns an array of post objects based on a given query, making it straightforward for developers to access forum content.

Where to use

The Discourse MCP Server can be utilized in environments that require integration with Discourse forums, such as web applications, internal tools, or any system that needs to leverage Discourse’s content. It offers flexibility in deployment through Docker or as a standalone Node.js application.

Content

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 .

Tools

search_posts
Search Discourse posts

Comments