About Linux Do MCP Server
Linux Do MCP Server is an MCP server for the LINUX DO community, exposing its topics, notifications, bookmarks and private messages. It suits users who want an AI assistant to browse that forum.
Key features
- 01Fetch latest, most active and popular topics
- 02Browse latest topics by category
- 03Search topics
- 04View notifications and unread topics
- 05View bookmarks and private messages with authentication
Use cases
- 01Asking an AI assistant to summarize popular community topics
- 02Searching community discussions through an AI assistant
- 03Checking personal notifications and unread posts
MCP support
The project is an MCP server that provides LINUX DO community API endpoints as tools for MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @pleasure1234/linux-do-mcpLINUX_DO_API_KEYSecretLINUX_DO_USERNAMELocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
12Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number, defaults to 1 |
| per_page | number | No | Number of items per page, defaults to 10 |
Details
From the project READMELinux Do MCP Server
中文 / English
Where possible begin!
API List
| Description | API Endpoint |
|---|---|
| Without Authentication | |
| Topics with new posts | https://linux.do/latest.json |
| Most active topics (past year/month/week/day) | https://linux.do/top.json |
| Recently popular topics | https://linux.do/hot.json |
| Latest classified topics | https://linux.do/categories_and_latest |
| With Authentication | |
| Recently created topics | https://linux.do/new.json |
| Topics with unread posts (tracked/followed) | https://linux.do/unread.json |
| New topics and unread posts (tracked/followed) | https://linux.do/unseen.json |
| Topics you posted in | https://linux.do/posted.json |
| Notifications | https://linux.do/notifications.json |
| Topic Search | https://linux.do/search/query.json |
| Bookmarks | https://linux.do/u/${your-username}/user-menu-bookmarks |
| Private messages | https://linux.do/u/${your-username}/user-menu-private-messages |
Tools List
- Topics with new posts
- Most active topics (past year/month/week/day)
- Recently popular topics
- Latest classified topics
- Recently created topics
- Topics with unread posts (tracked/followed)
- New topics and unread posts (tracked/followed)
- Topics you posted in
- Notifications
- Topic Search
- Bookmarks
- Private messages
Category List
| Category Name | Description | Id |
|---|---|---|
| Development | Includes content on development, testing, debugging, deployment, optimization, security, etc. | 4 |
| Resources | Shares software, open-source repositories, video courses, books, etc. | 14 |
| Documentation | Friends become academicians, let's compile books together | 42 |
| Flea Market | Trading-related section, including physical/virtual goods supply/demand, carpooling, etc. | 10 |
| Job Market | "Master skills to serve the emperor." Dedicated to job postings/hunting only. | 27 |
| Book Club | What's it like to finish a book with forum friends? | 32 |
| Set Sail | Set sail with the stars as our destination! | 46 |
| News Flash | Stay informed about the world without leaving home. | 34 |
| Web Archive | The internet never forgets - this is certain! | 92 |
| Benefits | "Who pays full price these days?" For sharing deals/giveaways. | 36 |
| Off-Topic | Casual chat section. No politics/NSFW content allowed. | 11 |
| Feedback | Discussions about this site, its organization, operations, and improvements. | 2 |
How to install
use python run this file to get your API_KEY
Node
{
"mcpServers": {
"linux-do-mcp": {
"command": "npx",
"args": [
"-y",
"@pleasure1234/linux-do-mcp"
],
"env": {
"LINUX_DO_API_KEY": "your-api-key-here",
"LINUX_DO_USERNAME": "your-username"
}
}
}
}
Python
{
"mcpServers": {
"linux-do-mcp": {
"command": "uvx",
"args": [
"linux-do-mcp"
],
"env": {
"LINUX_DO_API_KEY": "your-api-key-here",
"LINUX_DO_USERNAME": "your-username"
}
}
}
}
Reference
Copyright
-
Logo and community content © Linux DO Community
-
PAT generation script © this author
-
Project code © Pleasurecruise
This project is licensed under the MIT License.
Star History
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.