Kibela MCP Server
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
MCP server implementation for Kibela API integration, enabling LLMs to interact with Kibela content.
> [!TIP]
> This extension performs GraphQL schema introspection using the buildClientSchema, getIntrospectionQuery, and printSchema functions from the graphql package to reverse engineer Kibela's API. For more details, see her
Features
- Search notes with advanced filters
- Get your latest notes
- Get note content and comments
- Manage groups and folders
- Like/unlike notes
- List users
- View note attachments
- View recently viewed notes
- Get notes by path
Configuration
Environment Variables
- KIBELA_TEAM: Your Kibela team name (required)
- KIBELA_TOKEN: Your Kibela API token (required)
Cursor Integration
Add to your ~/.cursor/mcp.json:
If you want to use docker instead
Tools
kibela_search_notes
Search Kibela notes with given query
- Input:
- query (string): Search query
- coediting (boolean, optional): Filter by co-editing status
- isArchived (boolean, optional): Filter by archive status
- sortBy (string, optional): Sort by (RELEVANT, CONTENT_UPDATED_AT)
- userIds (string[], optional): Filter by user IDs
- folderIds (string[], optional): Filter by folder IDs
- Returns: List of matching notes with ID, title, URL, author, groups and more
kibela_get_my_notes
Get your latest notes from Kibela
- Input:
- limit (number, optional): Number of notes to fetch (default: 15)
- Returns: List of your latest notes with author information
kibela_get_note_content
Get content and comments of a specific note
- Input:
- id (string): Note ID
- include_image_data (boolean, optional): Whether to include image data URLs in the response (default: false)
- Returns: Full note content including HTML, comments, attachments, groups, folders and more
kibela_get_groups
Get list of accessible groups
- Input: None
- Returns: List of groups with details like privacy settings and permissions
kibela_get_group_folders
Get folders in a group
- Input:
- groupId (string): Group ID
- parentFolderId (string, optional): Parent folder ID for nested folders
- Returns: List of folders with their notes and metadata
kibela_get_group_notes
Get notes in a group that are not attached to any folder
- Input:
- groupId (string): Group ID
- Returns: List of notes with author information, sorted by last update time
kibela_get_folder_notes
Get notes in a folder
- Input:
- folderId (string): Folder ID
- limit (number, optional): Number of notes to fetch (default: 100)
- Returns: List of notes with author information, sorted by last update time
kibela_get_users
Get list of users
- Input: None
- Returns: List of users with ID, account and real name
kibela_like_note
Like a note
- Input:
- noteId (string): Note ID
- Returns: Updated likers list
kibela_unlike_note
Unlike a note
- Input:
- noteId (string): Note ID
- Returns: Updated likers list