Wi Graphql MCP Server

wi-graphql-mcp-server 翻译为中文是：“wi-GraphQL MCP 服务器”

 ](https://github.com/philip-hayden/wi-graphql-mcp-server/actions/workflows/auto-version.yml)

一个实现Wildlife Insights GraphQL API的模型上下文协议（MCP）服务器。该服务器为野生动物管理和物种识别提供了自然语言工具。

鹿 野生动物洞察力GraphQL API的自然语言接口

一个全面的模型上下文协议（MCP）服务器，提供直观的自然语言工具，用于访问Wildlife Insights数据。非常适合野生动物管理、物种识别工作流程以及德克萨斯州牧场运营。

](https://badge.fury.io/js/wildlife-insights-mcp) 

🌟 特点

🎯（目标、靶心） 20多个自然语言处理工具

• 数据导航： getMyOrganizations， exploreMyData， getMyProjects
• 物种鉴定： getIdentifyPhotosCount， submitIdentification， bulkIdentifyImages
• 分析与洞察: getRanchManagementInsights， getSpeciesAnalytics， getProjectAnalytics
• 上传管理: createUpload， uploadImageWorkflow， completeUpload
• 高级的： executeGraphQL 用于自定义查询

🦌 狩猎鹿 德克萨斯牧场优化版

• 德克萨斯州游戏物种分类
• 牧场管理目标一致性（保护/狩猎/生态旅游）
• 栖息地管理建议
• 季节性监测指南

🔧 翻译为中文是“扳手”或“螺丝刀”，具体根据上下文可能有所不同，但通常代表一种用于拧紧或松开螺丝的工具。 已准备好投入生产

• TypeScript 实现
• 全面的错误处理
• 完整的存储库文档
• 专业的部署选项

🚀 快速入门

安装

# Install from NPM (recommended)
npm install -g wildlife-insights-mcp

# Or from source
git clone https://github.com/yourusername/wildlife-insights-mcp.git
cd wildlife-insights-mcp
npm install

发展

# Start development server with hot reload
npm run dev

# Build for production
npm run build

# Start production server
npm start

MCP客户端配置

对于Cline/Cursor：

{
  "mcpServers": {
    "wildlife-insights": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": ["./node_modules/tsx/dist/cli.mjs", "src/server.ts"],
      "cwd": "/path/to/wildlife-insights-mcp",
      "env": {
        "WI_GRAPHQL_ENDPOINT": "https://api.wildlifeinsights.org/graphql",
        "WI_BEARER_TOKEN": "your_token_here"
      }
    }
  }
}

📖 使用示例

🏠 组织发现

// Find your organizations
await use_mcp_tool("wildlife-insights", "getMyOrganizations")

📊 项目分析

// Get Texas ranch management insights
await use_mcp_tool("wildlife-insights", "getRanchManagementInsights", {
  projectId: "2010935",
  ranchGoals: "balanced"
})

🦊 物种分析

// Analyze species in your project
await use_mcp_tool("wildlife-insights", "getSpeciesAnalytics", {
  projectId: "2010935"
})

📷 身份识别工作流程

// Check pending identifications
await use_mcp_tool("wildlife-insights", "getIdentifyPhotosCount", {
  projectId: "2010935"
})

// Get images for identification
await use_mcp_tool("wildlife-insights", "getImagesForIdentification", {
  projectId: "2010935",
  limit: 20
})

📤 上传管理

// Complete upload workflow
await use_mcp_tool("wildlife-insights", "uploadImageWorkflow", {
  projectId: "2010935",
  deploymentId: "2420851",
  fileName: "camera001.jpg",
  fileSize: "1024000"
})

🔧 认证

选项1：环境变量

export WI_BEARER_TOKEN="your_bearer_token_here"
npm run dev

选项2：运行时设置

// Set token for this session
await use_mcp_tool("wildlife-insights", "auth.setToken", {
  token: "your_bearer_token_here"
})

🏗️ 开发

项目结构

├── src/
│   ├── server.ts          # Main MCP server with all tools
│   ├── wiClient.ts        # GraphQL client wrapper
│   └── schemas/
│       └── operations.ts  # GraphQL query definitions
├── memory-bank/           # Complete project documentation
│   ├── projectbrief.md    # Core requirements
│   ├── productContext.md  # Problem/solution fit
│   ├── activeContext.md   # Current work focus
│   ├── systemPatterns.md  # Architecture patterns
│   ├── techContext.md     # Technical implementation
│   └── progress.md        # Status and roadmap
├── dist/                  # Compiled JavaScript (auto-generated)
└── examples/              # MCP client configurations

添加新工具

1. 添加GraphQL查询到 src/schemas/operations.ts
2. 在（系统/软件中）注册工具 src/server.ts
3. 更新内存库文档
4. 使用真实API调用进行测试

📋 可用工具

🏢 翻译为中文是：办公楼/公司/企业（的标志）。这个符号通常用来代表办公楼、公司或企业的形象，在各种标识、宣传材料中常见。 组织与项目管理

• getMyOrganizations - 发现无障碍组织
• getMyProjects - 浏览项目层级结构
• exploreMyData - 逐步数据探索
• getProjectDetails - 全面的项目信息

📊 表格/数据图表 分析与见解

• getProjectAnalytics - 项目整体指标
• getSpeciesAnalytics - 物种模式分析
• getRanchManagementInsights - 针对德克萨斯州的特定建议
• getDeploymentAnalytics - 相机部署优化

狐狸（🦊） 物种鉴定

• getIdentifyPhotosCount - 统计待确认的身份数量
• getImagesForIdentification - 提取图像以进行处理
• submitIdentification - 提交物种鉴定结果
• bulkIdentifyImages - 处理多张图像
• getIdentificationWorkflow - 监控进度

📤（一个表示“扔出”或“发送”的符号，常用于描述将物品或信息从一处扔出或发送到另一处的动作） 上传管理

• createUpload - 创建上传会话
• getUploadUrl - 获取签名上传URL
• completeUpload - 完成上传会话
• uploadImageWorkflow - 完整的上传工作流程

🔧（扳手，也用于表示修理、维护等动作或状态） 系统与高级功能

• executeGraphQL - 运行自定义的GraphQL查询
• auth.setToken - 管理认证
• auth.refreshToken - 令牌管理
• whoami - 服务器信息

🌍 德克萨斯州牧场焦点

这款MCP服务器专为德克萨斯州牧场野生动物管理进行了优化：

• 游戏物种白尾鹿，野猪，鬃狼（或称为环颈野猪）
• 管理目标保护、狩猎、生态旅游、平衡之道
• 栖息地类型德克萨斯州的生态系统和季节性模式
• 监管背景德克萨斯州野生动物管理规定及最佳实践

🤝 贡献

1. 克隆仓库
2. 创建一个特性分支
3. 为新功能添加测试
4. 更新内存库文档
5. 提交拉取请求

📄 许可证

MIT 许可证 - 详情请参见 LICENSE 文件。

🙏 致谢

• 野生动物洞察GraphQL API和平台
• MCP SDK（MCP软件开发工具包）模型上下文协议实现
• 德克萨斯州牧场主实际应用案例和反馈

📞 支持

• 问题：
• 讨论：
• 文档完整的内存库在 memory-bank/ 目录

______________________________________________________________________

倾注爱心，致力于野生动物保护与牧场管理