Discourse Mcp Server
Overview
What is Discourse MCP Server?
Discourse MCP Server is an open-source project designed to enhance the functionality of the Discourse platform, a popular discussion forum software. This server acts as a middleware that facilitates communication between Discourse and other applications or services, enabling features such as real-time notifications, user management, and data synchronization. The project is maintained by the developer AshDevFr and is available for public use on GitHub.
Features of Discourse MCP Server
- Real-Time Communication: The server supports WebSocket connections, allowing for instant updates and notifications within the Discourse platform.
- User Management: It provides tools for managing user accounts, including registration, authentication, and profile updates.
- Data Synchronization: The server ensures that data between Discourse and connected applications remains consistent and up-to-date.
- Customizable: Users can modify the server's code to fit their specific needs, making it a flexible solution for various use cases.
- Open Source: Being an open-source project, it allows developers to contribute to its development and improvement.
How to Set Up Discourse MCP Server
-
Clone the Repository: Start by cloning the Discourse MCP Server repository from GitHub using the command:
git clone https://github.com/AshDevFr/discourse-mcp-server.git
-
Install Dependencies: Navigate to the project directory and install the necessary dependencies. This typically involves running:
npm install
-
Configure the Server: Modify the configuration files to set up your server settings, including database connections and API keys.
-
Run the Server: Start the server using the command:
npm start
-
Integrate with Discourse: Follow the documentation to link your Discourse instance with the MCP Server, ensuring that all features are enabled and functioning correctly.
Frequently Asked Questions
What programming language is Discourse MCP Server written in?
Discourse MCP Server is primarily written in JavaScript, utilizing Node.js for server-side operations.
Is Discourse MCP Server free to use?
Yes, the Discourse MCP Server is an open-source project, which means it is free to use, modify, and distribute under the terms of the MIT license.
Can I contribute to the project?
Absolutely! Contributions are welcome. You can submit issues, feature requests, or pull requests on the GitHub repository.
How do I report a bug?
If you encounter any issues while using the Discourse MCP Server, please report them on the GitHub issues page of the repository, providing as much detail as possible.
Where can I find the documentation?
Documentation for setting up and using Discourse MCP Server can typically be found in the repository's README file or the Wiki section on GitHub.
Details
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 .
Server Config
{
"mcpServers": {
"discourse-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ashdevfr--discourse-mcp-server--discourse-mcp-server",
"node ./build/index.js"
],
"env": {
"DISCOURSE_API_URL": "discourse-api-url",
"DISCOURSE_API_KEY": "discourse-api-key",
"DISCOURSE_API_USERNAME": "discourse-api-username"
}
}
}
}