docbase

This MCP server implements a Docbase integration and exposes MCP endpoints to Search Posts, Get a Post, and Create a Post. After starting the server, clients can query for posts, retrieve individual posts by ID, and create new posts in Docbase using the MCP protocol. The environment variables DOCBASE_API_DOMAIN and DOCBASE_API_TOKEN are used to authenticate requests against the Docbase API. Use the available MCP tools to send requests to the server's endpoints and receive structured responses containing post data, metadata, and status information.

Prerequisites:

• Go installed (go1.18+ recommended)
• Access to a Docbase API domain with a valid API token

Installation steps:

1. Clone the repository git clone https://github.com/shogo-ma/docbase-mcp-server.git cd docbase-mcp-server

2. Build the MCP server binary go build -o docbase-mcp-server

3. Configure environment variables (example) export DOCBASE_API_DOMAIN="https://your-docbase-domain.com" export DOCBASE_API_TOKEN="your_docbase_api_token"

4. Run the server ./docbase-mcp-server

5. Verify the server is running by making a test MCP request to the appropriate endpoint (e.g., a health or info check endpoint if provided by the server).

Notes:

• The build outputs a binary named docbase-mcp-server. Adjust the path in mcp_config accordingly.
• Ensure network access to the Docbase API domain and that the API token has the required scopes.

Tips:

• Keep DOCBASE_API_DOMAIN and DOCBASE_API_TOKEN secure; do not commit them to version control.
• If you encounter authentication errors, double-check token validity and domain URL.
• The MCP server is designed to proxy requests to Docbase; if Docbase changes its API endpoints, update the server configuration accordingly.
• For debugging, run the server with logging enabled (if supported) and inspect request/response payloads.
• If you scale the server, ensure environment variables remain consistent across instances.