Get笔记 MCP Server
______________________________________________________________________
``
英语
概述
用于与Get集成的模型上下文协议（MCP）服务器笔记 （GetBiji）API，实现AI驱动的知识库搜索和检索功能。
特性
- ✅ 带stdio传输的MCP服务器框架
- ✅ Get笔记 带有承载令牌身份验证的API客户端
- ✅ 速率限制（2个QPS，5000个请求/天）
- ✅ 全面的错误处理和记录
- ✅ 具有完全类型安全的TypeScript
- ✅ 三种MCP工具：
- knowledge_search：人工智能增强的知识库搜索 - 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配置
- 复制环境模板：
cp .env.example .env- 编辑
.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工具
1.知识搜索
人工智能通过深度处理增强搜索，根据您的知识库提供全面的答案。
参数：
question（必填）：搜索查询topic_ids（可选）：知识库ID列表（目前支持1）-如果通过GET_BIJI_DEFAULT_TOPIC_ID配置，则可以省略deep_seek（必填）：促进深入思考refs（可选）：包括参考文献history（可选）：后续对话历史记录
2.知识调用
无需人工智能处理即可快速检索原始内容，可用于快速预览和原始数据访问。
参数：
question（必填）：搜索查询topic_id（可选）：单个知识库ID（首选）topic_ids（可选）：知识库ID列表top_k（可选）：排名靠前的结果数量（默认值：10）intent_rewrite（可选）：启用意图重写select_matrix（可选）：启用结果重新选择history（可选）：对话历史记录
注： 要么 topic_id 或 topic_ids 如果通过GET_BIJI_DEFAULT_TOPIC_ID配置，则可以省略。 topic_id 如果两者都提供，则优先考虑。
3.get_rate_limit_stats
获取当前API速率限制使用统计信息。
发展
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费率限制
- QPS:2个请求/秒
- 每日：5000次请求/天
服务器通过智能排队自动处理速率限制。
项目结构
.
├── 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技术栈
- Node.js（ES模块）
- TypeScript
- @模型上下文协议/sdk
- 阿西奥斯
- Dotenv。
许可证
麻省理工学院
贡献
欢迎投稿！请打开问题或提交拉取请求。
特别感谢 小伊宝潘 & 晓溪堡社区 支持癌症/罕见病患者及其家属❤️ & 人工智能！
该项目得到了小x宝社区的骄傲支持，致力于通过人工智能技术和社区支持来帮助癌症和罕见病患者及其家人。
______________________________________________________________________
``
中文
项目概述
一个用于集成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配置
- 复制环境变量模板:
cp .env.example .env- 编辑
.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工具说明
1.知识搜索
AI增强搜索,返回经过深度处理的答案。
参数:
question(必填): 搜索问题topic_ids(必填): 知识库ID列表(当前只支持1个)deep_seek(必填): 启用深度思考refs(可选): 返回引用来源history(可选): 对话历史,用于追问
2.知识调用
快速召回原始内容,不经过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
- @模型上下文协议/sdk
- 阿西奥斯
- Dotenv。
许可证
麻省理工学院
贡献
欢迎贡献！请提交 issue 或 pull request。
特别感谢小胰宝和 小x宝社区的贡献与付出，用爱心与人工智能为癌症/罕见病患者及其家庭提供支持！
🌟 小X宝公益社区
国内首个面向肿瘤/罕见病/慢性病的AI开源公益社区 *AI技术赋能*
- 专注AI+医疗公益应用
- 成功运营多个肿瘤AI助手（小胰宝、小肺宝等）
- 拥有丰富的患者服务经验