kbbi MCP

kbbi mcp

   

查询 KBBI 的 MCP 服务器。

python 3.13+

该项目公开了一个稳定的JSON工具输出，因此LLM客户端可以决定如何格式化、翻译或汇总结果。

与KBBI Daring的关系

这个项目是 非官方的 并且是 不隶属于 或由官方KBBI Daring服务背书。

特性

• MCP工具： kbbi_lookup(query: str)
• MCP资源： kbbi://{query} （有效载荷与 kbbi_lookup)
• 无需登录/身份验证流程
• 默认使用官方KBBI VI Daring

在MCP客户端中配置（JSON）

大多数MCP客户端（包括Claude Desktop）使用具有顶级JSON配置的JSON配置 mcpServers 对象。 这 mcpServers 格式是MCP生态系统中新兴的标准（参见：https://gofastmcp.com/integrations/mcp-json-configuration.md).

mcpServers-基于客户端（克劳德桌面/光标/Windsurf）

这符合许多Python MCP服务器使用的约定。

放在哪里：

• 克劳德桌面： ~/.claude/claude_desktop_config.json
• 光标： .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）
• 风浪： ~/.codeium/windsurf/mcp_config.json

{
	"mcpServers": {
		"kbbi": {
			"command": "uvx",
			"args": ["kbbi-mcp"]
		}
	}
}

注意：此示例使用 uvx （部分 uv)运行服务器。 在此处安装uv：https://docs.astral.sh/uv/getting-started/installation/

如果你不想依赖 uv，安装 kbbi-mcp 进入一个环境，并将您的客户端指向该环境的可执行文件。例如：

• 使用控制台脚本（建议在可用时使用）： kbbi-mcp
• 或者运行该模块： python -m kbbi_mcp

服务器直接查找KBBI VI Daring官方网站。

本地开发（从该仓库运行）

你需要 uv 安装：https://docs.astral.sh/uv/getting-started/installation/

此回购包括 fastmcp.json 定义如何运行服务器的文件（源+uv环境+stdio传输）。

要直接从此签出运行服务器，请执行以下操作：

fastmcp run

生成 mcpServers 您可以粘贴到MCP客户端配置中的条目：

fastmcp install mcp-json fastmcp.json

注意：生成的配置使用绝对路径，因此无论客户端的工作目录如何，它都能正常工作。

工具： kbbi_lookup

输入

• query （string）：一个单词或短语

工具参数示例：

{
	"query": "makan"
}

输出

返回一个JSON对象：

• found （布尔）
• query （字符串）
• url （字符串|空）
• entries （列表）
• suggestions （列表）
• error （string，可选）：仅在请求无效（例如空查询）或发生意外错误时显示

entries 使用具有规范化的英语密钥模式：

• etymology 始终存在（作为对象或 null)
• 相关单词列表始终存在（作为数组，可能为空）

这使得工具输出在源变量之间保持可预测性。

工具输出示例：

{
	"found": true,
	"query": "makan",
	"url": "https://kbbi.kemendikdasmen.go.id/entri/makan",
	"entries": [
		{
			"headword": "makan",
			"sense_number": "",
			"root_words": [],
			"pronunciation": "",
			"nonstandard_forms": [],
			"variants": [],
			"definitions": [],
			"etymology": null,
			"derived_words": [],
			"compound_words": [],
			"proverbs": [],
			"idioms": []
		}
	],
	"suggestions": []
}

资源： kbbi://{query}

此服务器还公开了与只读MCP资源相同的有效负载。

• kbbi://makan

对于低级调试，客户端将使用 resources/read 随着 {"uri": "kbbi://makan"}.

数据源

查找行为：

• 官方消息来源： https://kbbi.kemendikdasmen.go.id/entri/{query}

可选环境变量：

• KBBI_BASE_URL （默认值： https://kbbi.kemendikdasmen.go.id)
• KBBI_TIMEOUT_SECONDS （默认值： 10.0)