outline

This MCP server provides an Outline knowledge base integration built on the rmcp Rust MCP SDK. It authenticates each request by extracting human_user_id from the Authorization header and uses a global in-memory map to store per-user settings, specifically outline_url and outline_api_key. The server exposes tools that let you set or clear an author's Outline credentials, verify API access, and perform Outline document operations such as listing collections, searching, retrieving info, exporting documents as Markdown, and creating or updating documents. Before using any tool (except outline_set_auth or outline_clear_auth), the server will check that the current user has been configured with an outline_url and outline_api_key; if not configured, it will prompt to provide these details. Use the outline_auth_info tool to validate the API key with Outline's auth endpoint, and then proceed with other document operations.

Prerequisites:

• Rust toolchain (rustup, cargo)
• Internet access to fetch dependencies

1. Clone the repository: git clone <repository-url> cd <repository-folder>

2. Set up environment variables (optional defaults shown): export MCP_HOST=127.0.0.1 export MCP_PORT=3084

3. Build and run the server: cargo run

4. Verify the server is running:

   • Open http://127.0.0.1:3084/
   • Health check: http://127.0.0.1:3084/health
   • MCP endpoint: http://127.0.0.1:3084/mcp

5. Use the MCP client tools exposed by the server to configure and interact with Outline data.

Tips:

• The server stores per-user configuration in an in-memory Map. For production, consider replacing it with a persistent store (database) to preserve settings across restarts.
• Use outline_set_auth to save outline_url and outline_api_key for the current human_user_id. You can later clear it with outline_clear_auth.
• Outline API compatibility relies on outline_auth_info to validate the API key before performing document operations.
• Be mindful of rate limits and authentication scopes when interacting with Outline APIs (collecting, exporting, and updating documents).
• If you encounter a missing configuration prompt, ensure that the Authorization header correctly yields a valid human_user_id as intended by get_auth_context.