Hackage 文档 MCP

概述

此机器控制程序 (MCP) 提供了一个接口，供 AI 助手访问 Hackage 中的 Haskell 文档。它允许 AI 模型检索特定 Haskell 模块的精确、最新的文档，从而提高 AI 在 Haskell 编程方面的辅助能力，即使该领域中的训练数据有限。

问题陈述

与更主流的编程语言相比，AI 语言模型通常在 Haskell 上的训练数据不足。这导致：

• Haskell 的代码生成不太准确
• 难以理解 Haskell 的独特功能和抽象
• 关于 Haskell 库和模块的不准确或过时的信息

该工具通过使 AI 能够实时从 Hackage 检索权威文档来弥合这一差距。

特点

• 从 Hackage 上的任何软件包中检索特定模块的文档
• 指定确切的软件包版本以确保准确性
• 干净的、基于文本的输出，易于被 AI 助手使用

安装

1. 确保您已安装 Python 3.7+
2. 安装所需的依赖项：

   pip install httpx beautifulsoup4 fastmcp
   

用法

您可以将此 MCP 与任何支持 MCP 协议的 AI 助手一起使用。

运行服务器

python main.py

这将使用 stdio 传输启动 MCP 服务器。

API

MCP 公开了以下工具：

get_docs(package, version, module)

检索特定 Haskell 模块的文档。

参数：

• package (字符串): Hackage 软件包名称 (例如, "lens", "yesod-persistent")
• version (字符串): 软件包版本 (例如, "5.0.0", "2.10.0")
• module (字符串): 要查找的模块名称 (例如, "Control.Lens", "Database.Persist")

返回值：

• 指定模块的提取文档文本，如果检索失败，则返回错误消息

示例：

# 从 lens 5.0.0 获取 Control.Lens 的文档
get_docs("lens", "5.0.0", "Control.Lens")

# 从 vector-algorithms 0.8.0 获取 Data.Vector.Algorithms 的文档
get_docs("vector-algorithms", "0.8.0", "Data.Vector.Algorithms")

使用案例

1. 学习 Haskell 库：在使用 AI 时获取有关特定模块的详细信息
2. 理解类型签名：访问 Haskell 模块中函数的准确类型信息
3. 探索模块层次结构：了解模块如何在 Haskell 软件包中组织
4. 验证 AI 生成的代码：将 AI 建议与官方文档进行比较

益处

• 为 AI 提供对准确、最新的 Haskell 文档的访问
• 提高 AI 生成的 Haskell 代码的质量
• 增强 AI 使用权威参考解释 Haskell 概念的能力
• 减少讨论 Haskell 库时的幻觉

局限性

• 需要互联网连接才能访问 Hackage
• 仅提供文档内容，不提供实现代码
• Haskell 软件包之间的文档质量各不相同

贡献

欢迎为改进此工具做出贡献！ 一些潜在的增强领域：

• 增加对下载和解析软件包源代码的支持
• 实施缓存以减少网络请求
• 扩展以支持其他 Haskell 文档来源

许可证

[在此处指定您的许可证]