广告合作
MCP.so
登录

Discourse MCP Server

@discourse

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

discourse

提交者

Ric Harvey

关于 Discourse MCP Server

A Model Context Protocol (MCP) stdio server that exposes Discourse forum capabilities as tools for AI agents. Works with all deployments of discourse.org, self hosted or cloud hosted. just generate an API key to connect.

#knowledge-management#mcp-tools#discourse

Discourse MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "discourse": {
      "command": "npx",
      "args": [
        "-y",
        "@discourse/mcp@latest"
      ],
      "env": {}
    }
  }
}

Discourse MCP Server 工具

12

Validate and select a Discourse site. Returns JSON with site URL and title.

Search site content. Returns JSON object with results array of matching topics (id, slug, title) and meta (total, has_more).

Filter topics with a concise query language. Returns JSON object with results array (id, slug, title) and meta (page, limit, has_more). Query syntax: category/categories (comma=OR, '=category'=without subcats, '-'=exclude), tag/tags (comma=OR, '+'=AND), status:(open|closed|archived|listed|unlisted|public), in:(bookmarked|watching|tracking|muted|pinned), dates: created/activity-(before|after) YYYY-MM-DD or N days, order: activity|created|latest-post|likes|views with optional -asc.

Read topic metadata and posts. Returns JSON with id, title, slug, category_id, tags, and posts array.

Read a specific post. Returns JSON with id, topic_id, post_number, username, created_at, and raw content.

Get user info. Returns JSON with id, username, name, trust_level, created_at, bio, admin, and moderator.

Get paginated list of user posts/replies. Returns JSON object with posts array (id, topic_id, post_number, slug, title, created_at, excerpt, category_id) and meta (page, limit, has_more).

List users via admin API. Requires admin API key. Returns ~100 users per page (Discourse's fixed page size). Returns JSON with users array and pagination meta.

Get messages from a chat channel. Returns JSON object with channel_id, messages array (id, username, created_at, message, edited, thread_id, in_reply_to_id), and meta.

Retrieve a specific draft by key. Returns JSON with draft_key, sequence, and parsed data (title, reply, categoryId, tags, action).

Get full details of a Data Explorer query including SQL and parameters. Requires admin API key.

Execute a Data Explorer query with parameters. Returns columns, rows, result_count, duration_ms. Queries run in read-only transactions with 10-second timeout. Requires admin API key.

概览

What is Discourse Mcp Server?

A Model Context Protocol (MCP) stdio server that exposes Discourse forum capabilities as tools for AI agents. Built with @modelcontextprotocol/sdk and requires Node >=18. It allows agents to search, read, and optionally write to Discourse forums.

How to use Discourse Mcp Server?

Run with npx -y @discourse/mcp@latest (or globally via the discourse-mcp binary). Select a site at runtime via the discourse_select_site tool or tether to one using --site <url>. Enable writes with --allow_writes and --read_only=false, providing an API key via --auth_pairs. Configuration can also be stored in a JSON profile file.

Key features of Discourse Mcp Server?

  • Read‑only by default; writes are opt‑in and guarded.
  • Built‑in tools: search, read topics/posts, list categories/tags, filter topics.
  • Write tools: create posts, topics, categories, and users (when enabled).
  • Supports Admin API Keys and User API Keys for authentication.
  • Rate‑limited writes (~1 req/sec) with retries on 429/5xx.
  • Remote Tool Execution API for additional dynamic tools.

Use cases of Discourse Mcp Server?

  • An AI agent searching a Discourse forum for relevant discussions.
  • An automation reading topic content and summarizing it for a user.
  • A bot creating new topics or posts in a forum (with write permissions).
  • A tool that lists categories or tags to help navigate forum structure.
  • A user generating a User API Key without admin involvement.

常见问题

1

What authentication methods are supported?

Admin API Keys (`api_key` + `api_username`) and User API Keys (`user_api

评论

其他 分类下的更多 MCP 服务器

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

广告合作