Calculadora de Propostas

You can run this MCP server to automatically calculate commercial proposals by cost per hour, keep a persistent history, view advanced statistics, and interact with a Claude Desktop client through the MCP protocol.

How to use

You will connect a MCP client to either the HTTP endpoint or the local stdio interface to perform actions such as creating, listing, retrieving, and deleting quotations. The server computes final customer prices from base costs, taxes, load, margin, and commission, and then multiplies by estimated hours to yield the total project value. Access to interactive charts and a persistent JSON history helps you analyze and compare quotations over time.

How to install

Prerequisites: You need Node.js 18 or newer, npm 9 or newer, Claude Desktop, and Git.

# 1. Clone the repository
git clone https://github.com/silvaleo1979/MCP_APPS.git
cd MCP_APPS/calculadora-proposta-mcp

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Configure Claude Desktop with the MCP server
# Windows path
# %APPDATA%\Claude\claude_desktop_config.json
# macOS path
# ~/Library/Application Support/Claude/claude_desktop_config.json

# 5. Prepare the MCP server configuration (example shown in the guide)

After you have built the project, add the MCP server configuration to Claude Desktop to enable the stdio interface. The example below shows the command that will run the built application and expose the MCP protocol via stdio.

{
  "mcpServers": {
    "calculadora-proposta": {
      "command": "node",
      "args": [
        "/caminho/completo/para/MCP_APPS/calculadora-proposta-mcp/dist/index.js",
        "--stdio"
      ]
    }
  }
}

Additional steps for usage

If you plan to test through a browser, you can also run the HTTP server as described in the development scripts and access the MCP endpoint at the provided URL.

# Start HTTP-based MCP server (local testing, if applicable)
npm run start:http
# Then open http://localhost:3001/mcp in your browser

Notes

Restart Claude Desktop after adding or updating the MCP configuration. Ensure the correct path to the built index.js is used in the configuration. The MCP server exposes two methods: HTTP for remote access and stdio for direct desktop integration.

Available tools

create_quotation

Create a new quotation with complete data and receive a quotation object containing an ID.

list_quotations

List quotes with an optional limit to return an array of quotations.

get_quotation

Retrieve a specific quotation by its ID, returning the full quotation details.

delete_quotation

Delete a quotation by its ID and receive a confirmation.