Kibela

🚀 Kibela MCP Server

Kibela MCP Server is an open - source project that adheres to the Model Context Protocol (MCP). It aims to connect AI tools with the Kibela note - taking service. Through this server, AI models can access and manipulate note data in Kibela via the HTTP protocol.

✨ Features

• Search Notes: Supports querying note content by keywords or conditions.
• Create and Update Notes: Allows AI tools to generate, edit, and manage notes.
• Comment Interaction: Enables AI to add and reply to comments in notes, enhancing interactivity.
• File Management: Supports uploading and associating attachments to improve the extensibility of notes.
• Security Audit: Ensures that all operations comply with security standards and safeguard data integrity.

🔧 Technical Details

Tool Definitions

The following are the key pre - set tools in the MCP server and their functional descriptions:

Search Notes

• Function: Find specific notes by keywords or filtering conditions.
• Input Format: Supports free - text input and structured query parameters.
• Output Format: Returns the basic information and content summaries of matching notes.

Create New Notes

• Function: Generate new blank notes, allowing you to specify the title, content, and the group they belong to.
• Input Format: A JSON object containing the title, body, and group identifier.
• Output Format: Returns the unique identifier and link address of the newly created note.

Update Existing Notes

• Function: Modify or expand the content of existing notes.
• Input Format: Includes the note ID and the content fragments to be updated.
• Output Format: A status message confirming the success of the update operation.

Add Comments

• Function: Add new comment content under a specified note.
• Input Format: A data packet containing the comment text and the target note ID.
• Output Format: Returns the detailed information of the new comment and the link to the associated note.

📦 Installation

Operation Guide

1. Install Dependencies

   docker compose run mcp pnpm install
   

2. Start the Service

   docker compose up
   

3. Configure Environment Variables

   • Set KIBELA_ORIGIN to the address of your Kibela instance.
   • Configure KIBELA_ACCESS_TOKEN for authentication.

4. Mount the Configuration File (Optional)

   docker compose exec mcp bin/cli.mjs \
     --config=/path/to/your/config.json
   

Custom Configuration

You can further extend the server's functionality by writing custom tool descriptions and prompt files. The specific steps are as follows:

1. Create a JSON file, for example, custom - config.json:

   {
     "tools": {
       "search_kibela_note": {
         "description": "Search note content by keywords"
       }
     },
     "prompts": {
       "review": {
         "prompt": "Analyze and summarize the note content in the specified link and provide improvement suggestions."
       }
     }
   }
   

2. Mount this configuration file to the Docker container:

   docker run -v /path/to/custom-config.json:/config.json kibela-mcp-server
   

Test and Verification

Use the MCP Inspector tool to test the server's functionality:

npx mcp-inspector \
  --origin http://localhost:3000 \
  --token your-access-token

📄 License

This project is licensed under the MIT License, allowing free use, modification, and distribution.