piatra-mcp-server MCP Server

MCP server interface to the PIATRA API

Overview

This is a Model Context Protocol (MCP) server implementation for piatra-mcp-server. It provides tools and capabilities that can be used by MCP clients to interact with PIATRA API MCP.

Features

• Example Tool: A basic tool demonstrating the MCP server structure
• Add your custom tools and features here

Installation

From npm

npm install -g @piatra-open-source/piatra-mcp-server

From source

1. Clone the repository:

git clone https://gitlab.com/piatra_eng/machine-learning/piatra-mcp-server
cd piatra-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

Using with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "piatra-mcp-server": {
      "command": "npx",
      "args": ["@piatra-open-source/piatra-mcp-server"],
      "env": {
        // Add any required environment variables here
      }
    }
  }
}

Environment Variables

• DEBUG: Set to true to enable debug logging

Available Tools

example_tool

A demonstration tool that processes input and returns a formatted response.

Parameters:

• input (required): The input parameter for the example tool
• optional (optional): An optional parameter

Example usage:

{
  "tool": "example_tool",
  "arguments": {
    "input": "Hello, world!",
    "optional": "Extra information"
  }
}

Development

Prerequisites

• Node.js 18 or higher
• npm or yarn

Setup

1. Install dependencies:

npm install

2. Build the project:

npm run build

3. Run in development mode:

npm run dev

Adding New Tools

1. Define your tool in the TOOLS array in src/index.ts
2. Add the tool handler in the CallToolRequestSchema switch statement
3. Implement your tool's logic
4. Update this README with documentation for your new tool

Testing

Run the server in debug mode:

DEBUG=true npm start

Building

Build the TypeScript project:

npm run build

Watch for changes during development:

npm run watch

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

PIATRA COMMERCIAL

Support

For issues, questions, or suggestions, please open an issue.

Changelog

See CHANGELOG.md for version history and release notes.