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文档来源

许可证

[在此指定您的许可证]