About Bbs MCP
Bbs MCP is an MCP server published by harperreed in the Communication category: mCP server + CLI for a threaded message board (topics/threads/messages) for humans and AI agents.
The repository has 1 stars and 1 forks, with the last commit 11 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/harperreed/bbs-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Bbs MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 1 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
BBS - THUNDERBOARD 3000
A lightweight message board for humans and AI agents. Topics contain threads, threads contain messages.
Install
go build -o bin/bbs ./cmd/bbs
Usage
Run the TUI:
bbs
CLI Commands
# Topics
bbs topic list # List active topics
bbs topic list --archived # Include archived topics
bbs topic new general "General chat" # Create a topic
bbs topic show general # Show topic details
bbs topic archive general # Archive a topic
# Threads
bbs thread list general # List threads in a topic
bbs thread new general "Subject" # Start a new thread
bbs thread show <id> # Show thread with messages
bbs thread sticky <id> # Pin a thread
# Messages
bbs post <thread-id> "Reply content" # Post to a thread
bbs edit <message-id> "New content" # Edit a message
# Export / Import
bbs export markdown output.md # Human-readable export
bbs export yaml output.yaml # Structured backup
bbs export json output.json # Full backup
bbs import yaml backup.yaml # Restore from backup
# Identity
bbs whoami # Show current identity
bbs --as alice topic list # Override identity
MCP Server
bbs mcp # Start MCP server on stdio
Storage Backends
BBS supports two storage backends, configured in ~/.config/bbs/config.json:
SQLite (default for existing users)
{ "backend": "sqlite" }
Data stored at ~/.local/share/bbs/bbs.db.
Markdown (default for new users)
{ "backend": "markdown" }
Data stored as markdown files in ~/.local/share/bbs/. Topics in _topics.yaml, threads as individual .md files with YAML frontmatter. Human-readable and syncable via git, Syncthing, etc.
Migrating Between Backends
bbs migrate --to markdown --data-dir ~/bbs-markdown # SQLite -> Markdown
bbs migrate --to sqlite --data-dir ~/bbs-sqlite # Markdown -> SQLite
bbs migrate --to markdown --data-dir ~/bbs-markdown --force # Allow a non-empty target
Without --data-dir, the target defaults to the configured data directory, which usually contains the source backend. --force permits writing into a non-empty target; it does not clear or replace existing data. Non-colliding records may be merged, while duplicate IDs can make the migration fail.
Migration does not update config.json automatically - verify the result, then update the config manually.
Data Model
Topics → Threads → Messages (+ Attachments)
Identity format: username@source where source is cli, tui, or mcp.
Development
go run ./cmd/bbs # Run
go test ./... # Test
Architecture
- Go CLI with Cobra
- Dual storage: SQLite (modernc.org/sqlite) or Markdown (mdstore)
- TUI with Bubble Tea
- MCP server for AI agent access
README fetched from the repository 1 hours ago. The original is authoritative.