@fonkychen/nature-vision-mcp 0.1.1

package/README.md

@@ -0,0 +1,106 @@
+\# Nature Vision MCP Server
+
+
+
+An \*\*MCP (Model Context Protocol) server\*\* that identifies biological species from images using the \*\*Nature Vision API\*\*, returning Latin names with confidence scores.  
+
+This server enables LLMs (such as Claude) to recognize species and enrich responses with biological knowledge.
+
+
+
+---
+
+
+
+\## Features
+
+
+
+\- 🌿 Identify species from images (plants, animals, fungi, insects, etc.)
+
+\- 🧬 Returns \*\*Latin scientific names\*\* with confidence scores
+
+\- 🧠 Designed for \*\*LLM tool usage\*\* via Model Context Protocol (MCP)
+
+\- 🔌 Simple stdio-based MCP server
+
+\- 🚀 Easy to run with `npx`
+
+\- 🔐 API key via environment variables
+
+
+
+---
+
+
+
+\## Supported Categories
+
+
+
+\- `plant`
+
+\- `bug`
+
+\- `bird`
+
+\- `mammal`
+
+\- `reptile`
+
+\- `amphibian`
+
+\- `mollusc`
+
+\- `fungi`
+
+
+
+---
+
+
+
+\## Installation
+
+
+
+```bash
+
+npm install 
+
+```
+
+
+
+\*\*Configure in your MCP client:\*\*
+
+```json
+
+{
+  "mcp.servers": {
+    "nature-vision": {
+      "command": "npx",
+      "args": ["-y", "nature-vision-mcp"],
+      "env": {
+        "NATURE_VISION_API_KEY": "app-xxx"
+      }
+    }
+  }
+}
+
+
+```
+
+For now, you can use token: app-dummy-token-2026, this will allow you request once per minute. 
+```
+"NATURE_VISION_API_KEY": "app-dummy-token-2026"
+```
+
+
+
+```bash
+
+npx nature-vision-mcp
+
+
+

package/dist/index.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import fetch from "node-fetch";
+const API_ENDPOINT = "https://api.nature-vision.top/api/v1/mcp/vision";
+const API_KEY = process.env.NATURE_VISION_API_KEY;
+if (!API_KEY) {
+    console.error("NATURE_VISION_API_KEY environment variable is not set");
+    process.exit(1);
+}
+const server = new McpServer({
+    name: "nature-vision-mcp",
+    version: "0.1.0",
+});
+server.registerTool("identify_species", {
+    description: "Identify species from an image and return Latin names with confidence",
+    inputSchema: {
+        image_url: z
+            .string()
+            .min(10)
+            .optional()
+            .describe('image url to request'),
+        image_data: z
+            .string()
+            .min(100)
+            .optional()
+            .describe('base64 image to request'),
+        category: z
+            .string()
+            .min(3)
+            .optional()
+            .describe("species category: plant|bug|bird|reptile|mollusc|mammal|fungi|amphibian"),
+        top_k: z
+            .number()
+            .min(1)
+            .optional()
+            .describe("top_k"),
+    },
+}, async ({ image_url, image_data, category, top_k }) => {
+    try {
+        if (image_url && image_data) {
+            throw new Error("Either image_url or image_data is required");
+        }
+        const resp = await fetch(API_ENDPOINT, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${API_KEY}`,
+            },
+            body: JSON.stringify({
+                image_url: image_url ?? null,
+                image_data: image_data ?? null,
+                category: category ?? null,
+                top_k: top_k ?? 5,
+            }),
+        });
+        if (!resp.ok) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: ""
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const data = (await resp.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        source: data.source,
+                        results: data.results,
+                    }, null, 2),
+                },
+            ],
+            isError: false
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'unknown error';
+        console.error('request failed:', errorMessage);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: ""
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    try {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error('nature vision started');
+        console.error('waiting for client to request...');
+    }
+    catch (error) {
+        console.error('nature vision failed:', error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('server error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@fonkychen/nature-vision-mcp",
+  "mcpName": "io.github.fonkychen/nature-vision",
+  "version": "0.1.1",
+  "description": "An MCP (Model Context Protocol) server that identifies biological species from images, returning Latin names with confidence scores.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "nature-vision-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "nature-vision",
+    "ai-tools"
+  ],
+  "author": "fonky.chen@gmail.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fonkychen/nature-vision-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}