Linux Do MCP Server

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.