Kyomi

Kyomi MCP 服务

通过 Claude Code、Cursor 和任何兼容 MCP 的客户端查询您的数据仓库。

Kyomi 是一个 AI 数据智能平台，可连接您的数据仓库，并提供自然语言查询、仪表板、自动监控和积累的业务知识。MCP 服务会将这些功能提供给您的 AI 助手。

快速开始

Claude Code

claude mcp add kyomi --transport http https://app.kyomi.ai/mcp

重启 Claude Code。首次使用时，系统会提示您在浏览器中进行授权。

Cursor

1. 在 Kyomi 中前往 Settings > Profile
2. 点击 Connect with Cursor
3. 在 Cursor 中确认安装
4. 按提示在浏览器中进行授权

手动配置

将以下内容添加到您的 MCP 配置文件中：

{
  "mcpServers": {
    "kyomi": {
      "type": "http",
      "url": "https://app.kyomi.ai/mcp"
    }
  }
}

配置文件位置：

• Cursor：~/.cursor/mcp.json
• Claude Code：~/.claude/claude_desktop_config.json

可用工具

数据目录

工具	描述
search_catalog	对所有已连接的数据源进行语义搜索 — “查找客户收入表”
get_table_info	查看任意表的详细架构信息（列、类型、描述）
list_datasources	列出连接到您工作区的所有数据源

查询执行

工具	描述
query_datasource	对任何已连接的数据仓库或数据库运行 SQL 查询
validate_sql	执行前检查查询语法

知识库

工具	描述
search_learnings	获取团队积累的数据相关知识
save_learning	记录有关表、指标或业务规则的新见解

仪表板

工具	描述
search_dashboards	按内容或标题查找现有仪表板
get_dashboard_info	查看仪表板详情和 ChartML 内容
create_dashboard	使用 ChartML 可视化创建新仪表板

监控（自动监控）

工具	描述
search_watches	查找现有数据监控项
create_watch	设置自动数据监控和警报

网站分析

工具	描述
create_analytics_site	设置网站分析跟踪并获取 <script> 代码片段
list_analytics_sites	查看所有分析网站及其跟踪代码片段
update_analytics_site	更改网站名称或允许的域名
delete_analytics_site	移除分析网站及其所有数据

支持的数据源

Kyomi 可连接 9 个数据平台，均可通过相同的 MCP 工具访问：

平台	类型
BigQuery	云数据仓库
Snowflake	云数据仓库
PostgreSQL	关系型数据库
MySQL	关系型数据库
ClickHouse	列式分析数据库
Redshift	云数据仓库
Databricks	Lakehouse 平台
SQL Server	关系型数据库
Azure Synapse	云分析

使用示例

连接后，向您的 AI 助手提问：

"Search for tables related to customer orders"

"What columns are in the sales.transactions table?"

"Run a query to get yesterday's revenue by product category"

"What does our team know about calculating MRR?"

"Create a dashboard showing weekly active users trend"

"Set up a watch to alert me if daily signups drop below 10"

安全性

• 基于浏览器的 OAuth — 通过浏览器授权，令牌会自动刷新
• 工作区隔离 — 您只能查看自己工作区的数据
• 权限一致 — MCP 使用您现有的 Kyomi 凭据和数据源访问权限
• 20 行预览上限 — AI 查询最多返回 20 行作为上下文
• 数据留在您的数据仓库中 — Kyomi 直接查询，绝不复制或存储您的数据

为确保最高安全性，可在您的网络内部署 Kyomi Connect（开源，Apache 2.0），这样数据库凭据就不会离开您的基础设施。

文档

• 完整 MCP 文档
• Kyomi Connect（本地部署 Agent）
• 网站

许可证

Kyomi MCP 服务是一项托管服务。本仓库包含文档和设置说明。

Kyomi Connect 是一款本地部署的数据库 Agent，采用 Apache License 2.0 开源。