Linux Do MCP Server
About
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…
Details
- Author
- Pleasurecruise
- GitHub stars
- 52
- Downloads
- 440
- Categories
- Other
Jump to
- 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)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Linux Do MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
latest_topic
获取Linux.do有新帖子的话题
top_topic
获取Linux.do过去一年一月一周一天中最活跃的话题
hot_topic
获取Linux.do最近热门话题
category_topic
获取Linux.do特定分类下的话题
new_topic
获取Linux.do最近几天创建的话题
unread_topic
获取Linux.do您当前正在关注或追踪，具有未读帖子的话题
unseen_topic
获取Linux.do新话题和您当前正在关注或追踪，具有未读帖子的话题
post_topic
获取Linux.do您发过帖子的话题
new_notification
获取Linux.do您最近的未读通知
topic_search
搜索Linux.do论坛上的话题
my_bookmark
获取Linux.do您收藏的帖子
my_private_message
获取Linux.do您收到的私信
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"linux do mcp server": {
"linux-do": {
"command": "npx",
"args": [
"-y",
"@pleasure1234/linux-do-mcp"
],
"env": {
"LINUX_DO_API_KEY": "your-api-key-here",
"LINUX_DO_USERNAME": "your-username"
}
}
}
}
}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"
}
}
}Linux 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
1. Topics with new posts
2. Most active topics (past year/month/week/day)
3. Recently popular topics
4. Latest classified topics
5. Recently created topics
6. Topics with unread posts (tracked/followed)
7. New topics and unread posts (tracked/followed)
8. Topics you posted in
9. Notifications
10. Topic Search
11. Bookmarks
12. 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
