Mcp Kibela

# mcp-kibela 🗒️

[](https://smithery.ai/server/@kj455/mcp-kibela) [](https://www.npmjs.com/package/@kj455/mcp-kibela) [](https://opensource.org/licenses/MIT)

A Model Context Protocol (MCP) server implementation that enables AI assistants to search and reference Kibela content. This setup allows AI models like Claude to securely access information stored in Kibela.

Features 🚀

The mcp-kibela server provides the following features:

• 🔍 **Note Search**: Search Kibela notes by keywords
• 📝 **My Notes**: Fetch your latest notes
• 📖 **Note Content**: Get note content and comments by ID
• 🔗 **Note by Path**: Get note content by path

---

Prerequisites 📋

Before you begin, ensure you have:

• Node.js (v18 or higher)
• MCP Client (Claude Desktop, Cursor, etc.)
• Kibela Access Token ([How to get a token](https://support.kibe.la/hc/ja/articles/360036089931-APIアクセストークンの取得方法を教えてください))
• Git (if building from source)

Installation 🛠️

Choose one of the following installation methods:

Using Smithery

```bash npx -y @smithery/cli install @kj455/mcp-kibela --client claude ```

Using npm Package

```bash npm install -g @kj455/mcp-kibela ```

Building from Source

```bash git clone https://github.com/kj455/mcp-kibela.git cd mcp-kibela npm install npm run build ```

Configuration ⚙️

Claude Desktop

If you use Smithery, you don’t need to add this.

Add the following to your `claude_desktop_config.json`:

```json { “mcpServers”: { “kibela”: { “command”: “mcp-kibela”, “env”: { “KIBELA_TEAM”: “your-team-name”, “KIBELA_TOKEN”: “your-token” } } } } ```

If you use asdf

You will need this special configuration:

```json { “mcpServers”: { “kibela”: { “command”: “/bin/bash”, “args”: [“-c”, “npx -y @kj455/mcp-kibela@latest”], “env”: { “KIBELA_TEAM”: “your-team-name”, “KIBELA_TOKEN”: “your-token”, “PATH”: “/path/to/.asdf/shims:/usr/bin:/bin”, “ASDF_DIR”: “/opt/homebrew/opt/asdf/libexec”, “ASDF_DATA_DIR”: “/path/to/.asdf”, “ASDF_NODEJS_VERSION”: “your-nodejs-version” } } } } ```

If you built from source

You will need to modify the command and args like this:

```json { “mcpServers”: { “kibela”: { “command”: “/bin/bash”, “args”: [“-c”, “node dist/index.js”] // … other env configurations remain the same } } } ```

Cursor

Currently, ONLY [build from source](https://github.com/kj455/mcp-kibela#building-from-source) is supported.

After building from source, you need to modify Cursor Settings.

Cursor Settings -> Features -> MCP Servers -> Add new MCP server

• Name: `kibela` (or whatever you want)
• Type: `command`
• Command: `env KIBELA_TEAM=your_team_name KIBELA_TOKEN=your_token node /path/to/mcp-kibela/dist/index.js`

Environment Variables

The following environment variables are required:

• `KIBELA_TEAM`: Your Kibela team name (required)
• `KIBELA_TOKEN`: Your Kibela API token (required)

Contributing

Any contributions are welcome!

Development

1. Use `npm run build:watch` to build the project in watch mode.

```bash npm run build:watch ```

2. Use `npx @modelcontextprotocol/inspector` to inspect the MCP server.

```bash npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js ```

License 📄

MIT