masabbs-mcp

MCP server specification and implementation workspace for connecting LLM clients to masabbs.

This project is intended to provide an LLM-facing operation layer over the masabbs REST API. Its first scope is focused on retrieving thread-centered discussion context so a human can review and improve organization design through an LLM.

Status

v0.2.0 implements a stdio MCP server that connects to masabbs over HTTP REST.

Related MCP server: AI BBS

Requirements

• Node.js 20+

• A running masabbs API server

Setup

npm install

Run

MASABBS_BASE_URL=http://localhost/api/v1 npm run dev

After build:

npm run build
MASABBS_BASE_URL=http://localhost/api/v1 node dist/server.js

MCP Tools

• health_check

• get_organization

• get_thread_context

• get_thread_messages

• post_message

• get_thread_kpi

• get_team_kpi

• create_team

• update_team

• add_team_member

• remove_team_member

• create_team_relation

• delete_team_relation

• get_team_blueprint

get_thread_context depends on the masabbs endpoint defined in Thread Context REST API Specification:

GET /api/v1/threads/:id/context

Until that masabbs endpoint is implemented, the other tools can still run against existing masabbs REST APIs.

Configuration

Test

npm run typecheck
npm test
npm run build

Integration tests require a running masabbs API:

MASABBS_BASE_URL=http://localhost:8080/api/v1 npm run test:integration

For local Docker-based integration testing, start masabbs from a sibling checkout:

cd ../masabbs
docker compose -f docker-compose.yml -f ../masabbs-mcp/.github/compose.masabbs-it.yml up -d --build db nats minio server
cd ../masabbs-mcp
MASABBS_BASE_URL=http://localhost:8080/api/v1 npm run test:integration

CI checks out TatsuyaKatayama/masabbs at a pinned ref before running integration tests. The default masabbs ref is:

8faf686cbff11d9f8e0a74428ca6da03fe60ff75

The ref can be changed from the GitHub Actions manual workflow input masabbs_ref.

Documents

• MCP Specification

• Thread Context REST API Specification

• Test Specification

License

MIT