Linux Do MCP Server

Name: Linux Do MCP Server
Author: Pleasurecruise

@Pleasurecruise

Repository Homepage

About Linux Do MCP Server

A MCP Server For LINUX DO community

#mcp #modelpredictivecontrol #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "linux-do": {
      "command": "npx",
      "args": [
        "-y",
        "@pleasure1234/linux-do-mcp"
      ],
      "env": {
        "LINUX_DO_API_KEY": "your-api-key-here",
        "LINUX_DO_USERNAME": "your-username"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Linux Do MCP Server?

Linux Do MCP Server is an MCP (Model Context Protocol) server that interfaces with the Linux Do community (a Discourse-based forum). It provides tools to access community topics, notifications, bookmarks, private messages, and more via authenticated and unauthenticated API endpoints. The server is intended for LLM agents or users who want to query and interact with the Linux Do forum programmatically.

How to use Linux Do MCP Server?

Install the server by adding it to your MCP configuration (in JSON). For Node.js, use npx -y @pleasure1234/linux-do-mcp; for Python, use uvx linux-do-mcp. Set the environment variables LINUX_DO_API_KEY (obtainable via a provided Python script) and LINUX_DO_USERNAME. The server then exposes 12 tools that correspond to Discourse API endpoints.

Key features of Linux Do MCP Server

12 tools for topics, notifications, search, bookmarks, and private messages
Supports both unauthenticated and authenticated API calls
Includes a PAT (Personal Access Token) generation script
Integrates with the Linux Do community (Discourse platform)
Available for Node.js and Python runtimes
Community categories are predefined (e.g., Development, Resources, Off-Topic)

Use cases of Linux Do MCP Server

Retrieve the latest or most active topics from Linux Do
Search for specific topics using the discourse search API
Manage notifications and private messages for authenticated users
Access bookmarks and topics the user has posted in
Automate community monitoring or moderation tasks via an LLM agent

FAQ from Linux Do MCP Server

What dependencies are required to run Linux Do MCP Server?

You need Node.js to run the npx command or Python to run the uvx command. The server itself fetches data from the Linux Do Discourse API.

How do I authenticate with the server?

You must provide a LINUX_DO_API_KEY and your LINUX_DO_USERNAME as environment variables. The API key can be generated by running the src/get-pat.py script.

Can I use Linux Do MCP Server without authentication?

Yes, several endpoints (topics with new posts, most active topics, recently popular topics, latest classified topics) do not require authentication.

Where does the data come from?

All data is retrieved from the Linux Do community at https://linux.do using its Discourse API endpoints.

Is the server open-source and licensed?

Yes, the project is licensed under the MIT License. The logo and community content are © Linux Do Community, the PAT script © its author, and the project code © Pleasurecruise.