PTT MCP Server
The best PTT MCP server
What is PTT MCP Server?
PTT MCP Server 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 pttConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use PTT MCP Server
The PTT MCP Server connects AI assistants to PTT (批踢踢實業坊), Taiwan's largest BBS-style online community. Running as a Docker container, it uses the PyPtt library to authenticate as a PTT user and exposes tools for reading articles, posting, upvoting/downvoting, replying, managing private messages, and querying user and board information. Researchers, journalists, and Taiwanese internet users can use this server to have AI summarise discussions, monitor boards, or help draft PTT content.
Prerequisites
- Docker installed and running (recommended deployment method)
- A PTT account (PTT_ID and PTT_PW)
- Internet access to PTT (ptt.cc)
- An MCP client such as Claude Desktop
Pull the Docker image
The server is published as a pre-built container image on GitHub Container Registry. Pull it to your local Docker daemon.
docker pull ghcr.io/pyptt/ptt_mcp_server:latestTest the server manually
Run the container interactively with your PTT credentials to verify authentication works before wiring into a client.
docker run -i --rm -e PTT_ID=YOUR_PTT_ID -e PTT_PW=YOUR_PTT_PASSWORD ghcr.io/pyptt/ptt_mcp_server:latestAdd the server to Claude Desktop
Edit claude_desktop_config.json and add the mcpServers block shown below. The server passes credentials via environment variables to the Docker container.
Restart Claude Desktop
Quit and reopen Claude Desktop. The PTT server will start automatically when you send a request that requires it.
PTT MCP Server Examples
Client configuration
Add to claude_desktop_config.json. The Docker command passes PTT_ID and PTT_PW through to the container's environment.
{
"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_ID",
"PTT_PW": "YOUR_PTT_PASSWORD"
}
}
}
}Prompts to try
Queries in English and Traditional Chinese that exercise the PTT server's capabilities.
- "Log into PTT and show me the top 10 posts in the Gossiping board"
- "Read the latest 20 articles in the Tech_Job board and summarise the salary discussion"
- "Check my PTT private messages and tell me what they say"
- "Post a reply to article ID M.123456789.A.ABC in Baseball board saying '推'"
- "What is my P-coin balance?"Troubleshooting PTT MCP Server
Docker container exits immediately with authentication failure
Verify PTT_ID and PTT_PW are correct and that your account is not locked. PTT blocks accounts that fail login too many times. Try logging in at https://www.ptt.cc/bbs/ first.
Claude Desktop cannot find the 'docker' command
The full path to the Docker binary may be needed. Find it with 'which docker' and use the absolute path (e.g. /usr/local/bin/docker) as the command value in the config.
Server connects but tool calls return garbled text
PTT uses Big5 or UTF-8 encoding depending on the board. The PyPtt library handles encoding conversion, but if you see garbled output ensure you are using the latest image: 'docker pull ghcr.io/pyptt/ptt_mcp_server:latest'.
Frequently Asked Questions about PTT MCP Server
What is PTT MCP Server?
PTT MCP Server 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 Server?
Follow the installation instructions on the PTT MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with PTT MCP Server?
PTT MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is PTT MCP Server free to use?
Yes, PTT MCP Server is open source and available under the BSD-3-Clause license. You can use it freely in both personal and commercial projects.
PTT MCP Server Alternatives — Similar Communication Servers
Looking for alternatives to PTT MCP Server? 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 Server 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 Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.