Machbase Mcp

Machbase MCP 服务 v0.8.0

English | 한국어 | 日本語

概述

博客（韩语）：将 Claude MCP 接入 Machbase Neo，并体验 AI 式使用方式

本项目是一个基于 MCP（Model Context Protocol） 的服务，通过集成 Claude Desktop 和 Machbase Neo，支持使用自然语言执行数据库操作。

用户通过 Claude Desktop 的 MCP 连接以自然语言请求数据库操作时，MCP 服务会将这些请求转换为 Machbase Neo 命令并执行。

主要功能

• Machbase Neo 官方文档搜索与 AI 驱动的说明
  • Claude 直接搜索 Machbase 文档，提供准确信息
• 实时数据库集成
  • 创建表、操作数据、执行复杂查询
  • 通过 Claude 将自然语言转换为 SQL
• 时序数据分析与查询
  • 分析 IoT 传感器数据、日志数据及其他时序数据
• 原生 Claude Desktop 集成
  • 无需 LLM API 密钥，利用 Claude Desktop 的内置功能

工作原理

步骤	组件	角色	通信方式
1	用户	输入自然语言请求	聊天界面
2	Claude Desktop	解析请求并调用 MCP 工具	MCP Protocol
3	MCP 服务	生成 SQL 并连接到 Machbase	HTTP API（Neo API token）
4	Machbase Neo	执行数据库操作	SQL 查询

数据流：

User Request → Claude Desktop → MCP Server → Machbase Neo
↑                                                      ↓
Response ← Claude Interpretation ← MCP Response ← Query Results

要求

• Machbase Neo 8.7.2 或更高版本，并已启用令牌身份验证

  machbase-neo serve --http-enable-token-auth true
  

• Machbase Neo API token（参见签发 Neo API Token）
• 适用于 Windows、macOS 或 Linux 的 Claude Desktop（测试版，Ubuntu 22.04+ / Debian 12+）
  • https://claude.ai/download

签发 Neo API Token

1. 打开 Machbase Neo Web 控制台（http://<neo-host>:5654）并登录。

2. 点击盾牌图标 ①，然后点击 TOKENS 旁边的 + 按钮 ②。

3. 输入 token 名称 ③（例如 machbase-mcp），然后点击 Issue token ④。

   

4. 点击复制按钮 ⑤，复制已签发的 token。

   

明文 token 仅显示一次。如果丢失，请重新签发 token。

安装

快速设置

Windows

1. 安装 Claude Desktop 并启动一次

   • https://claude.ai/download

2. 从 Git 下载项目

   git clone https://github.com/machbase/machbase-mcp-server.git
   cd machbase-mcp-server/Machbase_MCP_Sever
   

3. 运行自动安装

   MCP_Install.bat
   

4. 设置 Neo API token

   • 打开安装结束时显示的 claude_desktop_config.json 文件。
   • 将 YOUR_NEO_API_TOKEN 替换为你签发的 token。
   • 完全退出 Claude Desktop（包括系统托盘图标），然后重新启动。

macOS

1. 从 Git 下载项目

   git clone https://github.com/machbase/machbase-mcp-server.git
   cd machbase-mcp-server/Machbase_MCP_Sever
   

2. 运行自动安装

   ./MCP_Install_mac.sh
   

3. 设置 Neo API token

   • 将 ~/Library/Application Support/Claude/claude_desktop_config.json 中的 YOUR_NEO_API_TOKEN 替换为你签发的 token。
   • 退出 Claude Desktop，然后重新启动。

Linux

1. 从 Git 下载项目

   git clone https://github.com/machbase/machbase-mcp-server.git
   cd machbase-mcp-server/Machbase_MCP_Sever
   

2. 运行自动安装

   ./MCP_Install_linux.sh
   

3. 设置 Neo API token

   • 将 ~/.config/Claude/claude_desktop_config.json 中的 YOUR_NEO_API_TOKEN 替换为你签发的 token。
   • 退出 Claude Desktop，然后重新启动。

安装后：输入“Show me the Machbase table list!”进行测试。

安装程序只会将 machbase 服务添加到 claude_desktop_config.json，并保留你的其他 MCP 服务和设置。再次运行安装程序进行更新时，会保留你已设置的 token。

配置文件位置

操作系统	claude_desktop_config.json
Windows（Microsoft Store 安装）	%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\
Windows（其他安装方式）	%APPDATA%\Claude\
macOS	~/Library/Application Support/Claude/
Linux	~/.config/Claude/

手动设置

如果要手动安装，或者在上述安装过程中出现错误，请按以下步骤操作：

1. 克隆仓库

   git clone https://github.com/machbase/machbase-mcp-server.git
   cd machbase-mcp-server/Machbase_MCP_Sever
   

2. 设置 Python 环境

   # Using Conda
   conda create -n mcp python=3.11
   conda activate mcp
   
   # Using venv
   python -m venv mcp-env
   source mcp-env/bin/activate  # Linux/macOS
   # mcp-env\Scripts\activate   # Windows
   

3. 安装依赖项

   pip install -r requirements.txt
   

4. 配置 Claude Desktop 和 MCP 服务

   • 将 Machbase.py 和 neo 文件夹复制到 Claude 配置文件夹（请参阅配置文件位置）。
   • 将 machbase 服务添加到同一文件夹中的 claude_desktop_config.json：

   {
     "mcpServers": {
       "machbase": {
         "command": "C:/Users/<Username>/anaconda3/envs/mcp/python.exe",
         "args": ["C:/Users/<Username>/AppData/Roaming/Claude/Machbase.py"],
         "env": {
           "MACHBASE_HOST": "localhost",
           "MACHBASE_PORT": "5654",
           "MACHBASE_TOKEN": "<your Neo API token>"
         }
       }
     }
   }
   

   变量	描述	默认值
   MACHBASE_HOST	Machbase Neo 主机	127.0.0.1
   MACHBASE_PORT	Machbase Neo HTTP 端口	5654
   MACHBASE_TOKEN	Machbase Neo API 令牌	（必填）

使用示例

你可以在 Claude Desktop 中用自然语言提出以下请求：

"Create a table for temperature logs"
"Insert today's temperature: 28.4°C at 9am"
"Show me the latest 10 rows from temperature_log"
"Search the Machbase documentation for 'data insertion'"
"Drop the table named old_sensor_data"
"Show average temperature over the past 3 days"
"What tables exist in my Machbase database?"
"List all columns in sensor_data"
"Generate a trend report for device_001"

Machbase MCP 服务评估得分

更新日期	版本	得分	平均响应时间	综合评价	模型
2025-08-28	v0.2.0	96 / 100	22 秒	与之前版本相比，回答质量有所提升； 不过，对于 TQL 相关问题的表现似乎仍不够理想。	Claude Sonnet 4
2025-09-03	v0.3.0	99 / 100	61.5 秒	响应时间明显更长，但解释比之前的版本准确、详细得多。	Claude Sonnet 4
2025-09-09	v0.4.0	141 / 150	45.29 秒	速度比之前有所提升，但脚本和 TQL 部分仍有不足	Claude Sonnet 4
2025-10-14	v0.5.0	185 / 200	3 秒	思考时间比之前显著改善，但 TQL 和 HTML 相关方面仍需改进。	Claude Sonnet 4.5
2025-10-24	v0.6.0	196 / 200	2.6 秒	与 v0.5.0 相比准确性有所提升。DBMS 相关内容需要重新验证。整体表现和响应时间均显著改善。	Claude Sonnet 4.5
2026-02-25	v0.7.0	198 / 200	6.7 秒	增强的执行验证功能明显弥补了代码回答中的错误；与之前的版本（0.6.x）相比，准确性有所提升。	Claude Sonnet 4.6