PTT MCP
The best PTT MCP server
What is PTT MCP?
PTT MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to best ptt mcp server
The best PTT MCP server
This server falls under the Communication and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- The best PTT MCP server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx ptt-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use PTT MCP
PTT MCP Server connects AI assistants to PTT (批踢踢實業坊), Taiwan's largest BBS platform, enabling programmatic access to boards, articles, mailboxes, and user accounts. It runs as a Docker container that authenticates with your PTT credentials and exposes tools for reading, posting, and interacting with content. Developers and researchers use it to integrate PTT community data into AI-driven workflows, automate monitoring of boards, or build conversational agents that can fetch and summarize posts on demand.
Prerequisites
- Docker installed and running on your machine
- A valid PTT account (PTT_ID and PTT_PW)
- An MCP-compatible client such as Claude Desktop, Gemini, or a custom host
- Network access to PTT (ptt.cc)
Install Docker
PTT MCP Server is distributed as a Docker image. Install Docker Desktop (macOS/Windows) or Docker Engine (Linux) from the official Docker documentation before proceeding.
docker pull ghcr.io/pyptt/ptt_mcp_server:latestObtain your PTT credentials
You need an active PTT account. Your PTT_ID is your login username and PTT_PW is your password. These are passed to the container as environment variables — never hard-code them in shared config files.
Add the server to your MCP client configuration
Open your MCP client config file (e.g., claude_desktop_config.json for Claude Desktop or ~/.gemini/settings.json for Gemini) and add the PTT server block. The Docker command mounts your credentials via -e flags at runtime.
{
"mcpServers": {
"PTT": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "PTT_ID",
"-e", "PTT_PW",
"ghcr.io/pyptt/ptt_mcp_server:latest"
],
"env": {
"PTT_ID": "your_ptt_username",
"PTT_PW": "your_ptt_password"
}
}
}
}Restart your MCP client
Save the configuration file and restart your MCP client application so it picks up the new server definition. Claude Desktop, for example, must be quit and relaunched.
Verify the connection
Ask your AI assistant to log in to PTT and list available boards. The server should authenticate with your credentials and return a success status. Follow the server's guideline: always read before writing, and confirm before executing destructive actions.
PTT MCP Examples
Client configuration
Complete claude_desktop_config.json snippet for PTT MCP Server using Docker transport.
{
"mcpServers": {
"PTT": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "PTT_ID",
"-e", "PTT_PW",
"ghcr.io/pyptt/ptt_mcp_server:latest"
],
"env": {
"PTT_ID": "your_ptt_username",
"PTT_PW": "your_ptt_password"
}
}
}
}Prompts to try
Sample prompts that exercise the server's article, mailbox, and account tools.
- "Log in to PTT and show me the latest 10 posts on the Gossiping board."
- "Search PTT's Baseball board for posts about the 統一獅 in the past week and summarize the top discussions."
- "Check my PTT mailbox and list any unread messages."
- "Post a reply to article #M.123456789 on the MobileComm board saying 'Thanks for sharing!'"
- "How many P-coins do I have and what is my current PTT user level?"Troubleshooting PTT MCP
Docker container exits immediately with authentication error
Double-check that PTT_ID and PTT_PW in your config exactly match your PTT login credentials, including case. Also confirm your PTT account is not locked due to too many failed logins — try logging in via the web first.
MCP client shows the PTT server as disconnected or unavailable
Ensure Docker is running before launching your MCP client. Run 'docker pull ghcr.io/pyptt/ptt_mcp_server:latest' to make sure the image is present locally, then restart the MCP client.
Write operations (posting, replying) fail silently
PTT enforces post-count and time limits on newer accounts. Confirm your account meets PTT's eligibility requirements for posting. Also ensure you are reading the article first before attempting a reply, as the server requires prior read state.
Frequently Asked Questions about PTT MCP
What is PTT MCP?
PTT MCP is a Model Context Protocol (MCP) server that best ptt mcp server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install PTT MCP?
Follow the installation instructions on the PTT MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with PTT MCP?
PTT MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is PTT MCP free to use?
Yes, PTT MCP is open source and available under the BSD-3-Clause license. You can use it freely in both personal and commercial projects.
PTT MCP Alternatives — Similar Communication Servers
Looking for alternatives to PTT MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up PTT MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use PTT MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.