Skip to main content
Glama
Get笔记 MCP Server

Get笔记 MCP Server

Get笔记 MCP Server

English | 中文


<a name="english"></a>

English

Overview

A Model Context Protocol (MCP) server for integrating with Get笔记 (GetBiji) API, enabling AI-powered knowledge base search and retrieval capabilities.

Features

  • ✅ MCP server framework with stdio transport

  • ✅ Get笔记 API client with Bearer token authentication

  • ✅ Rate limiting (2 QPS, 5000 requests/day)

  • ✅ Comprehensive error handling and logging

  • ✅ TypeScript with full type safety

  • ✅ Three MCP tools:

    • knowledge_search: AI-enhanced knowledge base search

    • knowledge_recall: Raw content retrieval

    • get_rate_limit_stats: Rate limit statistics

Installation

Option 1: Install globally (recommended for frequent use)

npm install -g mcp-get-biji-server

Option 2: Use with npx (no installation required)

npx mcp-get-biji-server

Option 3: Install as project dependency

npm install mcp-get-biji-server

Configuration

  1. Copy the environment template:

cp .env.example .env
  1. Edit .env and add your API key:

GET_BIJI_API_KEY=your_api_key_here
GET_BIJI_API_BASE_URL=https://open-api.biji.com/getnote/openapi
LOG_LEVEL=info
REQUEST_TIMEOUT=30000
RATE_LIMIT_QPS=2
RATE_LIMIT_DAILY=5000

Usage with Claude Desktop

Edit your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):

Using global installation:

{
  "mcpServers": {
    "get-biji": {
      "command": "mcp-get-biji-server",
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Using npx:

{
  "mcpServers": {
    "get-biji": {
      "command": "npx",
      "args": ["-y", "mcp-get-biji-server"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Using local installation:

{
  "mcpServers": {
    "get-biji": {
      "command": "node",
      "args": ["/path/to/node_modules/mcp-get-biji-server/build/index.js"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Restart Claude Desktop to activate the server.

MCP Tools

AI-enhanced search with deep processing, providing comprehensive answers based on your knowledge base.

Parameters:

  • question (required): Search query

  • topic_ids (optional): Knowledge base ID list (currently supports 1) - can be omitted if configured via GET_BIJI_DEFAULT_TOPIC_ID

  • deep_seek (required): Enable deep thinking

  • refs (optional): Include references

  • history (optional): Conversation history for follow-up

2. knowledge_recall

Fast retrieval of raw content without AI processing, useful for quick previews and raw data access.

Parameters:

  • question (required): Search query

  • topic_id (optional): Single knowledge base ID (preferred)

  • topic_ids (optional): Knowledge base ID list

  • top_k (optional): Number of top results (default: 10)

  • intent_rewrite (optional): Enable intent rewriting

  • select_matrix (optional): Enable result re-selection

  • history (optional): Conversation history

Note: Either topic_id or topic_ids can be omitted if configured via GET_BIJI_DEFAULT_TOPIC_ID. topic_id takes priority if both are provided.

3. get_rate_limit_stats

Get current API rate limit usage statistics.

Development

npm run build        # Compile TypeScript
npm run watch        # Watch mode compilation
npm run dev          # Build and run
npm test             # Run tests
npm start            # Run (must build first)

API Rate Limits

  • QPS: 2 requests/second

  • Daily: 5000 requests/day

The server automatically handles rate limiting with intelligent queuing.

Project Structure

.
├── src/                  # Source code
│   ├── index.ts         # MCP server entry
│   ├── client.ts        # API client
│   ├── config.ts        # Configuration
│   ├── logger.ts        # Logging system
│   ├── rate-limiter.ts  # Rate limiter
│   ├── types.ts         # Type definitions
│   └── test.ts          # Test script
├── build/               # Compiled output
├── .env                 # Environment variables
└── package.json         # Project config

Tech Stack

  • Node.js (ES Modules)

  • TypeScript

  • @modelcontextprotocol/sdk

  • Axios

  • dotenv

License

MIT

Related MCP server: Get Notes MCP Server

Contributing

Contributions welcome! Please open an issue or submit a pull request.

Special thanks to the contribution & development of Xiaoyibao-Pancrepal & xiao-x-bao community to support cancer/rare disease patients and their families with ❤️ & AI!

This project is proudly supported by the xiao-x-bao community, dedicated to helping cancer and rare disease patients and their families through AI technology and community support.


<a name="chinese"></a>

中文

项目概述

一个用于集成Get笔记API的Model Context Protocol (MCP)服务器,实现AI增强的知识库搜索和召回功能。

功能特性

  • ✅ 基于stdio传输的MCP服务器框架

  • ✅ 支持Bearer Token认证的Get笔记API客户端

  • ✅ 速率限制 (2 QPS, 5000次/天)

  • ✅ 完善的错误处理和日志记录

  • ✅ TypeScript完整类型安全

  • ✅ 三个MCP工具:

    • knowledge_search: AI增强知识库搜索

    • knowledge_recall: 原始内容召回

    • get_rate_limit_stats: 速率限制统计

安装

方式1: 全局安装 (推荐常用场景)

npm install -g mcp-get-biji-server

方式2: 使用 npx (无需安装)

npx mcp-get-biji-server

方式3: 作为项目依赖安装

npm install mcp-get-biji-server

配置

  1. 复制环境变量模板:

cp .env.example .env
  1. 编辑 .env 文件,添加您的API密钥:

GET_BIJI_API_KEY=your_api_key_here
GET_BIJI_API_BASE_URL=https://open-api.biji.com/getnote/openapi
LOG_LEVEL=info
REQUEST_TIMEOUT=30000
RATE_LIMIT_QPS=2
RATE_LIMIT_DAILY=5000

在Claude Desktop中使用

编辑Claude Desktop配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json):

使用全局安装:

{
  "mcpServers": {
    "get-biji": {
      "command": "mcp-get-biji-server",
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

使用 npx:

{
  "mcpServers": {
    "get-biji": {
      "command": "npx",
      "args": ["-y", "mcp-get-biji-server"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

使用本地安装:

{
  "mcpServers": {
    "get-biji": {
      "command": "node",
      "args": ["/path/to/node_modules/mcp-get-biji-server/build/index.js"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

重启Claude Desktop以激活服务器。

MCP工具说明

AI增强搜索,返回经过深度处理的答案。

参数:

  • question (必填): 搜索问题

  • topic_ids (必填): 知识库ID列表(当前只支持1个)

  • deep_seek (必填): 启用深度思考

  • refs (可选): 返回引用来源

  • history (可选): 对话历史,用于追问

2. knowledge_recall

快速召回原始内容,不经过AI处理。

参数:

  • question (必填): 搜索问题

  • topic_id (可选): 单个知识库ID(优先使用)

  • topic_ids (可选): 知识库ID列表

  • top_k (可选): 返回前N个结果(默认:10)

  • intent_rewrite (可选): 启用意图重写

  • select_matrix (可选): 启用结果重选

  • history (可选): 对话历史

注意: topic_id 和 topic_ids 必须提供一个,优先使用 topic_id。

3. get_rate_limit_stats

获取当前API速率限制使用统计。

开发命令

npm run build        # 编译TypeScript代码
npm run watch        # 监听模式编译
npm run dev          # 编译并运行
npm test             # 运行测试
npm start            # 直接运行(需先编译)

API限制

  • QPS限制: 2次/秒

  • 日限制: 5000次/天

服务器内置智能排队的速率限制器,自动处理这些限制。

项目结构

.
├── src/                  # 源代码目录
│   ├── index.ts         # MCP服务器入口
│   ├── client.ts        # API客户端
│   ├── config.ts        # 配置管理
│   ├── logger.ts        # 日志系统
│   ├── rate-limiter.ts  # 速率限制器
│   ├── types.ts         # TypeScript类型定义
│   └── test.ts          # 测试脚本
├── build/               # 编译输出目录
├── .env                 # 环境变量配置
└── package.json         # 项目配置文件

技术栈

  • Node.js (ES模块)

  • TypeScript

  • @modelcontextprotocol/sdk

  • Axios

  • dotenv

许可证

MIT

贡献

欢迎贡献!请提交 issue 或 pull request。

特别感谢小胰宝和 小x宝社区的贡献与付出,用爱心与人工智能为癌症/罕见病患者及其家庭提供支持!

🌟 小X宝公益社区

国内首个面向肿瘤/罕见病/慢性病的AI开源公益社区 AI技术赋能

  • 专注AI+医疗公益应用

  • 成功运营多个肿瘤AI助手(小胰宝、小肺宝等)

  • 拥有丰富的患者服务经验

Available Tools

3 tools
get_rate_limit_statsB

获取当前API速率限制使用情况统计

Inputs: no named parameters.

knowledge_recallB

在Get笔记知识库中召回相关内容,返回未经AI处理的原始结果。可用于快速查找和预览。

Inputs: question (required), topic_id, topic_ids, top_k, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: get_rate_limit_stats handles API monitoring, knowledge_recall provides raw search results, and knowledge_search delivers AI-processed answers. The descriptions make it impossible to confuse these tools as they target fundamentally different operations.

    Naming Consistency4/5

    The naming follows a consistent snake_case pattern throughout, but there's a minor deviation in verb style: 'get_' prefix for one tool versus 'knowledge_' prefix for the other two. This small inconsistency prevents a perfect score, though the overall naming remains highly readable and predictable.

    Tool Count3/5

    With only 3 tools, the set feels thin for a note-taking/knowledge management server, as it lacks basic CRUD operations like creating, updating, or deleting notes. While the tools cover API monitoring and search functions, the scope appears incomplete, making this borderline appropriate.

    Completeness2/5

    There are significant gaps in the tool surface for a note-taking server: no tools for creating, editing, organizing, or deleting notes, which are core to the domain. The tools focus only on search and API monitoring, leaving agents unable to perform essential workflows, likely causing failures in typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables interaction with SiYuan Note through its API for comprehensive note management. Supports searching, creating, editing documents, managing notebooks, and daily notes operations through natural language commands.
      15
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Rememberizer.ai knowledge repositories to search, retrieve, and store information across sources like Slack, Gmail, and Google Drive. It supports semantic search and agentic queries to access and manage personal or team internal knowledge.
      Apache 2.0
    • A
      license
      B
      quality
      A
      maintenance
      Enables AI models to interact with the Get笔记 (GetNotes) platform via its Open API. It supports managing notes, organizing knowledge bases, and handling tags through natural language commands.
      49
      2,583 npm
      93
      MIT