TianGong LCA

tiangong-lca-mcp

typescript

7

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "linancn-tiangong-lca-mcp": {
      "command": "npx",
      "args": [
        "dotenv",
        "-e",
        ".env",
        "--",
        "npx",
        "-p",
        "@tiangong-lca/mcp-server",
        "tiangong-lca-mcp-stdio"
      ]
    }
  }
}

TianGong LCA MCP Server enables clients to communicate via STDIO or streamable HTTP, making it easy to run locally or in containers while supporting robust testing and inspection tooling.

How to use

You can run the MCP server locally and connect client tools or editors that support the MCP protocol. Start the STDIO server to interact directly from your terminal or IDE, and you can test with the MCP Inspector to observe requests and responses in real time. If you prefer containerized deployment, you can run the server in Docker and expose the MCP port to your environment.

How to install

Prerequisites you should have installed before starting:

Node.js and npm (Node.js 14+ is recommended; npm comes with Node).

Install and run via STDIO locally

npm install -g @tiangong-lca/mcp-server

npx dotenv -e .env -- \
npx -p @tiangong-lca/mcp-server tiangong-lca-mcp-stdio

Run via Docker (optional)

# Build MCP server image (optional)
docker build -t linancn/tiangong-lca-mcp-server:0.0.5 .

# Pull MCP server image
docker pull linancn/tiangong-lca-mcp-server:0.0.5

# Start MCP server using Docker
docker run -d \
  --name tiangong-lca-mcp-server \
  --publish 9278:9278 \
  --env-file .env \
  linancn/tiangong-lca-mcp-server:0.0.5

Local testing commands

To test the STDIO server locally, run the following command to launch the server in STDIO mode via your usual Node tooling.

npm start

Test the Streamable Http server

If you want to test the HTTP-based streamable endpoint, use the dedicated start script for the HTTP server.

npm run start:server

Launch MCP Inspector

To inspect MCP traffic and requests, launch the MCP Inspector with authentication disabled for quick testing.

DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector

Notes on usage and testing

The STDIO approach runs locally from the command line or an editor that supports STDIO MCP, while the HTTP approach targets a streamable HTTP endpoint. Use the Inspector to observe the interactions and verify that requests and responses conform to the expected MCP behavior. If you modify environment variables via a .env file, ensure those values are available to both the server and your client during testing.

Available tools

MCP Inspector

Launch MCP Inspector to observe requests and responses and verify MCP protocol interactions during development and testing.