MCP MAGMA Handbook Server

🧙‍♂️ MCP MAGMA手册服务器

](https://badge.fury.io/js/mcp-magma-handbook) 

智能MCP（模型上下文协议）服务器，通过高级向量搜索和语义理解，为AI助手提供对MAGMA计算代数系统手册的全面访问。

✨ 特性

• 🔍 语义搜索：整个MAGMA手册中的自然语言查询
• 📚 智能示例：检索按复杂性和主题分类的代码示例
• 🧠 代码说明：获取MAGMA代码的详细上下文解释
• 🏷️ 类别筛选：在特定类别内搜索（语法、函数、算法、示例、理论）
• ⚡ 矢量数据库：由Supabase pgvector提供支持，用于闪电般快速的相似性搜索
• 🎯 MAGMA优化：对MAGMA语法和概念的专门解析和理解

🎯 非常适合

• 🔬 研究人员 使用计算代数
• 👨‍🎓 学生 学习MAGMA和代数计算
• 💻 开发者 构建数学软件
• 📖 任何人 需要快速访问MAGMA文档

🚀 快速开始

安装

npm install -g mcp-magma-handbook

先决条件

• Node.js 18+
• OpenAI API密钥（用于嵌入）
• Supabase帐户（免费版效果很好！）
• MAGMA手册PDF

设置

1. 将您的MAGMA手册PDF放在 data/pdfs/ 目录：

   mkdir -p data/pdfs
   cp /path/to/MAGMA_HANDBOOK.pdf data/pdfs/

1. 将手册编入索引：

   npm run index

1. 配置您的MCP客户端（例如，Claude Desktop）：

   {
     "mcpServers": {
       "magma-handbook": {
         "command": "npx",
         "args": ["mcp-magma-handbook"],
         "env": {
           "OPENAI_API_KEY": "your-api-key-here"
         }
       }
     }
   }

用法

配置后，AI助手可以使用这些工具：

搜索gma

在MAGMA手册中搜索特定主题：

"Search for information about elliptic curves in MAGMA"

get_maga_example

获取数学主题的代码示例：

"Show me MAGMA examples for computing Galois groups"

explain_magma_code

获取MAGMA代码的解释：

"Explain this MAGMA code: E := EllipticCurve([GF(23) | 1, 1]);"

💬 对话示例

配置后，您可以向Claude提出以下问题：

基本语法：

“我如何在MAGMA中定义有限域？”

代码示例：

“展示有限域上椭圆曲线计算的示例”

代码说明：

“解释一下MAGMA代码： G := PerfectClosure(GF(8)); H := AutomorphismGroup(G);"

高级主题：

“寻找计算伽罗瓦多项式群的算法”

研究帮助：

“在MAGMA中使用代数曲线有哪些可用函数？”

环境变量

• OPENAI_API_KEY：嵌入生成所需（使用text-embedding-3-small）
• CHROMA_SERVER_HOST：可选，用于远程ChromaDB实例
• CHROMA_SERVER_PORT：可选，用于远程ChromaDB实例

发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

🛠️ 技术细节

建筑

• 后端：使用TypeScript的Node.js
• 矢量数据库：带有pgvector扩展的Supabase
• 嵌入：OpenAI文本嵌入3-small
• 文档处理：LangChain采用优化分块技术
• 协议：MCP（模型上下文协议）1.0

演出

• 8,730+ 索引文档块
• ~175批 为了高效处理
• 亚秒 搜索响应
• 语义相似性 评分

🤝 贡献

我们欢迎捐款！请查看我们的 贡献指南 了解详情。

开发设置

git clone https://github.com/LeGenAI/mcp-magma-handbook.git
cd mcp-magma-handbook
npm install
npm run dev

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 岩浆队 关于综合计算代数系统
• Anthropic 对于模型上下文协议
• Supabase 优秀的矢量数据库平台
• OpenAI 用于强大的嵌入模型

______________________________________________________________________

由以下材料制成❤️ 为计算代数社区