MD2poster

Provides a simple MCP tool to add two numbers using a npx-based package within an MCP framework.

typescript

GitHub Stars

typescript

Language

5 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": {
    "pidanmeng-mcp-md2poster": {
      "command": "npx",
      "args": [
        "-y",
        "@pidanmoe/mcp-md2poster"
      ],
      "env": {
        "FOLDER": "{{FOLDER}}",
        "GITHUB_REPO": "{{GITHUB_REPO}}",
        "GITHUB_OWNER": "{{GITHUB_OWNER}}",
        "GITHUB_TOKEN": "{{GITHUB_TOKEN}}",
        "GITHUB_BRANCH": "{{GITHUB_BRANCH}}"
      }
    }
  }
}

You can run and connect to a small MCP tool package that exposes a simple add operation, implemented with FastMCP. This server is designed to perform a basic arithmetic action via the MCP protocol and can be integrated with any MCP client that supports standard input/output or other MCP transports.

How to use

You interact with the server through an MCP client by invoking the available tool and sending the required inputs. In this package, you can perform a numeric addition by providing two operands and receiving their sum. Use this when you need to offload simple arithmetic to a dedicated MCP service within your workflow or automation pipeline.

How to install

Prerequisites you need on your machine:

Node.js or Bun installed on your system. Bun is used in the project’s runtime workflow.

bun install

Build and run the server

To run the MCP server in development mode, use the command below. This starts the local MCP server that exposes the tools via the MCP protocol.

bun run dev

Configuration

The MCP server is configured to run as a stdio (local) MCP server. It uses npx to install and execute the package, and it passes necessary environment variables for GitHub access and the default folder for uploads.

{
  "mcpServers": {
    "mcp_md2poster": {
      "args": ["-y","@pidanmoe/mcp-md2poster"],
      "command": "npx",
      "env": {
        "GITHUB_TOKEN": "{{GITHUB_TOKEN}}",
        "GITHUB_OWNER": "{{GITHUB_OWNER}}",
        "GITHUB_REPO": "{{GITHUB_REPO}}",
        "GITHUB_BRANCH": "{{GITHUB_BRANCH}}",
        "FOLDER": "{{FOLDER}}"
      }
    }
  }
}

Notes

The server follows the MCP protocol and communicates through standard input/output with MCP-compatible clients. Ensure you provide the required environment variables when you deploy or run in your environment.

Configuration and endpoints

An MCP stdio configuration is provided to start the server via the npx command and to pass the necessary package and arguments. The server exposes an add tool that accepts two operands and returns their sum.

{
  "mcpServers": {
    "mcp_md2poster": {
      "args": ["-y","@pidanmoe/mcp-md2poster"],
      "command": "npx",
      "env": {
        "GITHUB_TOKEN": "{{GITHUB_TOKEN}}",
        "GITHUB_OWNER": "{{GITHUB_OWNER}}",
        "GITHUB_REPO": "{{GITHUB_REPO}}",
        "GITHUB_BRANCH": "{{GITHUB_BRANCH}}",
        "FOLDER": "{{FOLDER}}"
      }
    }
  }
}

Available tools

add

Adds two numbers by accepting operands a and b and returning their sum.

Built by

VeilStrat

AI signals for GTM teams