AI导哈

语料库查询服务器

KonText MCP服务器是一个实现模型上下文协议（MCP）的服务，为KonText语料库查询引擎提供结构化的、优化LLM的接口，支持AI代理进行复杂的语言研究、语料库查询和共现分析。

  • by honzas83
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 honzas83/kontext-mcp

使用说明

KonText MCP服务器

实施 模型上下文协议（MCP） 它为 KonText 语料库查询引擎。

该服务器允许人工智能代理（如克劳德）在LINDAT/CLARIAH-CZ维护的数百个语料库中执行复杂的语言研究、语料库查询和搭配分析。

特性

  • 语料库发现：列出并过滤可用语料库（包括并行语料库）。
  • 高级搜索：支持基本关键字搜索和复杂关键字搜索 语料库查询语言（CQL） 表达。
  • 平行体（对齐）：完全支持在具有特定逻辑的对齐语料库（例如English-Czech）中搜索，以处理API对齐约束。
  • 分析工具:
    • 频率分布：按单词、引理、标签或文档元数据对结果进行分组。
    • 搭配：识别搜索结果周围具有统计意义的单词配对。
  • 直接Web集成：每个搜索结果都包含一个 web_url 这将在浏览器中打开确切的搜索状态供人类查看。
  • LLM优化：工具使用详细 Annotated 键入提示和文档字符串，以引导模型通过多步语言工作流程。

安装

先决条件

  • Python 3.10+
  • LINDAT/KnText帐户（公共语料库可选，某些受限语料库需要）。

设置

  1. 克隆此存储库：

    git clone https://github.com/honzas83/kontext-mcp.git
cd kontext-mcp

  2. 创建虚拟环境并安装依赖项：

    python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

配置

克劳德桌面版

要将此服务器与Claude Desktop一起使用，请将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "kontext": {
      "command": "/path/to/your/kontext-mcp/.venv/bin/python",
      "args": ["/path/to/your/kontext-mcp/kontext_mcp.py"]
    }
  }
}

Gemini CLI

将以下内容添加到您的 ~/.gemini/settings.json:

{
  "mcpServers": {
    "kontext": {
      "command": ".venv/bin/python",
      "args": [
        "kontext_mcp.py"
      ]
    }
  }
}

Codex CLI

将以下内容添加到您的 .codex/config.toml:

[mcp_servers.kontext]
command = ".venv/bin/python"
args = ["kontext_mcp.py"]
enabled = true

工具概述

  • list_corpora：查找语料库ID（例如。， bnc, czeng_20).
  • get_corpus_details：探索可用属性（引理、标签）和元数据。
  • search_concordance：执行初始搜索。支持 align 并行结果的参数。
  • view_concordance：通过结果进行分页。
  • get_frequency：生成频率表。
  • get_collocations：执行搭配分析。
  • filter_concordance：优化结果（正/负过滤器）。
  • get_hit_details：获取特定事件的元数据（作者、日期等）。

技术说明：平行搜索

当通过JSON请求时，KonText API需要两步过程来正确初始化并行（对齐）搜索。此MCP服务器通过以下方式自动处理此问题：

  1. 正在初始化主语料库上的搜索。
  2. 立即使用对齐参数调用视图端点。 这可确保LLM始终收到正确对齐的数据和可用的浏览器链接。

联系

Jan schwec honzas@fav.zcu.cz
控制论系
比尔森西波西米亚大学

学分和许可证

该项目是一个独立的MCP实施。底层服务由提供 LINDAT/CLARIAH-CZ请尊重他们 服务条款 当使用API时。

许可证：麻省理工学院

相关 MCP