@tiangong-lca/mcp-server 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 linancn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# TianGong-LCA-MCP
+
+[中文](./README.md) | [English](./README_EN.md)
+
+TianGong LCA Model Context Protocol (MCP) Server 支持 STDIO 和 SSE 两种协议。
+
+## 启动 MCP 服务器
+
+### 客户端 STDIO 服务器
+
+```bash
+npm install -g @tiangong-lca/mcp-server
+
+npx dotenv -e .env -- \
+npx @tiangong-lca/mcp-server
+```
+
+### 远程 SSE 服务器
+
+```bash
+npm install -g @tiangong-lca/mcp-server
+npm install -g supergateway
+
+npx dotenv -e .env -- \
+npx -y supergateway \
+    --stdio "npx -y @tiangong-lca/mcp-server" \
+    --port 3001 \
+    --ssePath /sse --messagePath /message
+```
+
+### 使用 Docker
+
+```bash
+# 使用 Dockerfile 构建 MCP 服务器镜像（可选）
+docker build -t linancn/tiangong-lca-mcp-server:0.0.1 .
+
+# 拉取 MCP 服务器镜像
+docker pull linancn/tiangong-lca-mcp-server:0.0.1
+
+# 使用 Docker 启动 MCP 服务器
+docker run -d \
+    --name tiangong-lca-mcp-server \
+    --publish 3001:80 \
+    --env-file .env \
+    linancn/tiangong-lca-mcp-server:0.0.1
+```
+
+## 开发
+
+### 环境设置
+
+```bash
+# 安装 Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash
+nvm install 22
+nvm use
+
+# 安装依赖
+npm install
+
+# 更新依赖
+npm update && npm ci
+```
+
+### 代码格式化
+
+```bash
+# 使用代码检查工具格式化代码
+npm run lint
+```
+
+### 本地测试
+
+#### STDIO 服务器
+
+```bash
+# 使用 MCP Inspector 启动 STDIO 服务器
+npm start
+```
+
+#### SSE 服务器
+
+```bash
+# 打包当前项目
+npm run build && npm pack
+
+# 如果需要可以全局安装 supergateway（可选）
+npm install -g supergateway
+
+# 启动 SSE 服务器，如配置了参数 --baseUrl ，应设置为有效的 IP 地址或域名
+npx dotenv -e .env -- \
+npx -y supergateway \
+    --stdio "npx -y tiangong-lca-mcp-server-0.0.1.tgz" \
+    --port 3001 \
+    --ssePath /sse \
+    --messagePath /message
+
+# 启动 MCP Inspector
+npx @modelcontextprotocol/inspector
+```
+
+### 发布
+
+```bash
+npm login
+
+npm run build && npm publish
+```

package/dist/src/_shared/clean_object.js

@@ -0,0 +1,22 @@
+const cleanObject = (obj) => {
+    if (Array.isArray(obj)) {
+        return obj
+            .map((v) => (typeof v === 'object' ? cleanObject(v) : v))
+            .filter((v) => v !== undefined && v !== null);
+    }
+    else if (typeof obj === 'object' && obj !== null) {
+        const cleanedObj = Object.entries(obj)
+            .map(([k, v]) => [k, cleanObject(v)])
+            .reduce((acc, [k, v]) => {
+            if (v !== undefined &&
+                v !== null &&
+                (typeof v !== 'object' || (typeof v === 'object' && Object.keys(v).length > 0))) {
+                acc[k] = v;
+            }
+            return acc;
+        }, {});
+        return cleanedObj;
+    }
+    return obj;
+};
+export default cleanObject;

package/dist/src/_shared/config.js

@@ -0,0 +1,4 @@
+export const base_url = process.env.BASE_URL ?? '';
+export const supabase_anon_key = process.env.SUPABASE_ANON_KEY ?? '';
+export const x_api_key = process.env.X_API_KEY ?? '';
+export const x_region = process.env.X_REGION ?? '';

package/dist/src/_shared/init_server.js

@@ -0,0 +1,13 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { regFlowSearchTool } from '../tools/flow_hybrid_search.js';
+import { regProcessSearchTool } from '../tools/process_hybrid_search.js';
+export function initializeServer() {
+    const server = new McpServer({
+        name: 'TianGong-MCP-Server',
+        version: '1.0.0',
+    });
+    regFlowSearchTool(server);
+    regProcessSearchTool(server);
+    return server;
+}
+export const server = initializeServer();

package/dist/src/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { regFlowSearchTool } from './tools/flow_hybrid_search.js';
+import { regProcessSearchTool } from './tools/process_hybrid_search.js';
+const server = new McpServer({
+    name: 'TianGong-MCP-Server',
+    version: '1.0.0',
+});
+regFlowSearchTool(server);
+regProcessSearchTool(server);
+async function runServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+runServer().catch((error) => {
+    console.error('Fatal error running server:', error);
+    process.exit(1);
+});

package/dist/src/index_server.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import express from 'express';
+import { server } from './_shared/init_server.js';
+const app = express();
+app.use(express.json());
+app.post('/mcp', async (req, res) => {
+    try {
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+        res.on('close', () => {
+            console.log('Request closed');
+            transport.close();
+            server.close();
+        });
+    }
+    catch (error) {
+        console.error('Error handling MCP request:', error);
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: '2.0',
+                error: {
+                    code: -32603,
+                    message: 'Internal server error',
+                },
+                id: null,
+            });
+        }
+    }
+});
+app.get('/mcp', async (req, res) => {
+    console.log('Received GET MCP request');
+    res.writeHead(405).end(JSON.stringify({
+        jsonrpc: '2.0',
+        error: {
+            code: -32000,
+            message: 'Method not allowed.',
+        },
+        id: null,
+    }));
+});
+app.delete('/mcp', async (req, res) => {
+    console.log('Received DELETE MCP request');
+    res.writeHead(405).end(JSON.stringify({
+        jsonrpc: '2.0',
+        error: {
+            code: -32000,
+            message: 'Method not allowed.',
+        },
+        id: null,
+    }));
+});
+const PORT = Number(process.env.PORT ?? 9278);
+const HOST = process.env.HOST ?? '0.0.0.0';
+app.listen(PORT, HOST, () => {
+    console.log(`MCP Stateless Streamable HTTP Server listening on port ${PORT}`);
+});

package/dist/src/tools/_shared/clean_object.js

@@ -0,0 +1,22 @@
+const cleanObject = (obj) => {
+    if (Array.isArray(obj)) {
+        return obj
+            .map((v) => (typeof v === 'object' ? cleanObject(v) : v))
+            .filter((v) => v !== undefined && v !== null);
+    }
+    else if (typeof obj === 'object' && obj !== null) {
+        const cleanedObj = Object.entries(obj)
+            .map(([k, v]) => [k, cleanObject(v)])
+            .reduce((acc, [k, v]) => {
+            if (v !== undefined &&
+                v !== null &&
+                (typeof v !== 'object' || (typeof v === 'object' && Object.keys(v).length > 0))) {
+                acc[k] = v;
+            }
+            return acc;
+        }, {});
+        return cleanedObj;
+    }
+    return obj;
+};
+export default cleanObject;

package/dist/src/tools/_shared/config.js

@@ -0,0 +1,4 @@
+export const base_url = process.env.BASE_URL ?? '';
+export const supabase_anon_key = process.env.SUPABASE_ANON_KEY ?? '';
+export const x_api_key = process.env.X_API_KEY ?? '';
+export const x_region = process.env.X_REGION ?? '';

package/dist/src/tools/flow_hybrid_search.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import cleanObject from '../_shared/clean_object.js';
+import { base_url, supabase_anon_key, x_api_key, x_region } from '../_shared/config.js';
+const input_schema = {
+    query: z.string().min(1).describe('Queries from user'),
+};
+async function searchFlows({ query }) {
+    const url = `${base_url}/flow_hybrid_search`;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${supabase_anon_key}`,
+                'x-api-key': x_api_key,
+                'x-region': x_region,
+            },
+            body: JSON.stringify(cleanObject({
+                query,
+            })),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return JSON.stringify(data);
+    }
+    catch (error) {
+        console.error('Error making the request:', error);
+        throw error;
+    }
+}
+export function regFlowSearchTool(server) {
+    server.tool('Search_flows_Tool', 'Search LCA flows data.', input_schema, async ({ query }) => {
+        const result = await searchFlows({
+            query,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result,
+                },
+            ],
+        };
+    });
+}

package/dist/src/tools/process_hybrid_search.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import cleanObject from '../_shared/clean_object.js';
+import { base_url, supabase_anon_key, x_api_key, x_region } from '../_shared/config.js';
+const input_schema = {
+    query: z.string().min(1).describe('Queries from user'),
+};
+async function searchProcesses({ query }) {
+    const url = `${base_url}/process_hybrid_search`;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${supabase_anon_key}`,
+                'x-api-key': x_api_key,
+                'x-region': x_region,
+            },
+            body: JSON.stringify(cleanObject({
+                query,
+            })),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return JSON.stringify(data);
+    }
+    catch (error) {
+        console.error('Error making the request:', error);
+        throw error;
+    }
+}
+export function regProcessSearchTool(server) {
+    server.tool('Search_processes_Tool', 'Search LCA processes data.', input_schema, async ({ query }) => {
+        const result = await searchProcesses({
+            query,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result,
+                },
+            ],
+        };
+    });
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@tiangong-lca/mcp-server",
+  "version": "0.0.2",
+  "description": "TianGong LCA MCP Server",
+  "license": "MIT",
+  "author": "Nan LI",
+  "type": "module",
+  "bin": {
+    "tiangong-lca-mcp-stdio": "dist/src/index.js",
+    "tiangong-lca-mcp-http": "dist/src/index_server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/src/*.js",
+    "start": "npm run build && npx dotenv -e .env -- npx @modelcontextprotocol/inspector node dist/src/index.js",
+    "start:server": "npm run build && npx dotenv -e .env -- node dist/src/index_server.js",
+    "lint": "prettier -c --write \"**/**.{js,jsx,tsx,ts,less,md,json}\""
+  },
+  "dependencies": {
+    "@types/express": "^5.0.1",
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "@supabase/supabase-js": "^2.49.4",
+    "zod": "^3.24.3"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.10.2",
+    "dotenv-cli": "^8.0.0",
+    "prettier": "^3.5.3",
+    "prettier-plugin-organize-imports": "^4.1.0",
+    "shx": "^0.4.0",
+    "supergateway": "^2.7.0",
+    "typescript": "^5.8.3"
+  }
+}