AI导哈

农业智能协议服务器

一个用于农业智能的模型上下文协议服务器，提供害虫/疾病查询、政府计划发现和中小企业知识检索功能。

  • by alumnx-ai-labs
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 alumnx-ai-labs/agrigpt-backend-mcp

使用说明

Alumx MCP服务器

用于农业智能的模型上下文协议（MCP）服务器，通过语义搜索提供害虫/疾病查找、政府方案发现和SME知识检索的工具。

特性

  • 病虫害 --基于RAG的作物病虫害信息查找
  • 政府计划 --RAG按类型和州搜索与农业相关的政府计划
  • 中小企业部 --Pinecone知识库（SME-Divesh命名空间）上的语义搜索
  • MCP+休息 --双接口：MCP协议（通过FastMCP）和纯REST(/callTool)

需求

  • Python 3.9+
  • 依赖关系（通过安装 pip install -r requirements.txt):
fastmcp
pinecone
sentence-transformers
python-dotenv
uvicorn
httpx
fastapi

环境变量

创建一个 .env 项目根目录中的文件，包含以下变量：

变量 必填 描述
PESTS_DISEASES_RAG_URL ✅ 病虫害RAG服务的基本URL
GOVT_SCHEMES_RAG_URL ✅ 政府计划RAG服务的基本URL
PINECONE_API_KEY ✅ Pinecone的API密钥
PINECONE_INDEX ✅ 要查询的松果索引的名称
RAG_TIMEOUT ❌ RAG调用的HTTP超时（秒）（默认值： 30)

示例 .env:

PESTS_DISEASES_RAG_URL= ___URL__
GOVT_SCHEMES_RAG_URL= __URL__
PINECONE_API_KEY=your-pinecone-api-key
PINECONE_INDEX=your-index-name
RAG_TIMEOUT=30

运行服务器

python alumnx_mcp_server.py

服务器启动于 端口9000 默认情况下。

端点 描述
/mcp MCP协议端点（FastMCP）
/callTool REST工具调用端点
/list-tools 列出所有可用工具
/health 健康检查

MCP工具

pests_and_diseases

查询RAG系统，了解影响作物的病虫害信息。

参数 类型 必填 默认 说明
pest_name string ✅ — 病虫害名称
crop string ❌ "General" 受虫害或病害影响的作物

示例响应：

{
  "status": "success",
  "information": "...",
  "sources": ["..."]
}

govt_schemes

查询RAG系统中与农业相关的政府方案。

参数 类型 必填 默认 说明
scheme_type string ✅ — 方案的类型或主题
state string ❌ "All India" 检索方案的州

示例响应：

{
  "status": "success",
  "information": "...",
  "sources": ["..."]
}

sme_divesh

使用以下方法对SME Divesh Pinecone命名空间进行语义搜索 all-MiniLM-L6-v2 嵌入。

参数 类型 必填 默认 说明
query string ✅ — 搜索查询
top_k 整数 ❌ 5 要返回的顶级结果数

示例响应：

{
  "status": "success",
  "query": "crop irrigation techniques",
  "results": [
    {
      "score": 0.91,
      "text": "...",
      "source": "...",
      "chunk_index": 2
    }
  ]
}

REST API使用

所有工具也可以通过调用 /callTool POST端点：

curl -X POST http://localhost:9000/callTool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pests_and_diseases",
    "arguments": {
      "pest_name": "aphids",
      "crop": "wheat"
    }
  }'

建筑

┌─────────────────────────────────────────┐
│            Alumnx MCP Server            │
│                                         │
│  FastAPI App                            │
│  ├── /mcp          ← FastMCP (MCP)      │
│  ├── /callTool     ← REST interface     │
│  ├── /list-tools   ← Tool discovery     │
│  └── /health       ← Health check       │
│                                         │
│  Tools                                  │
│  ├── pests_and_diseases → RAG HTTP call │
│  ├── govt_schemes       → RAG HTTP call │
│  └── sme_divesh         → Pinecone      │
└─────────────────────────────────────────┘

相关 MCP