Calc Tools

🚀 MCP Calculation Tools Protocol (MCP Calc Tools)

A Model Context Protocol (MCP) server that offers advanced mathematical and financial calculation tools, which can be integrated with AI code assistants such as Cline and Roo Code.

🚀 Quick Start

MCP Calc Tools exposes mathematical calculation capabilities through a standard interface, enabling AI tools to perform complex calculations without directly implementing mathematical algorithms.

✨ Features

Mathematical Tools

• Symbolic Calculus
  • derivative: Calculate the symbolic derivative of an expression.
  • integral: Calculate the symbolic integral.
  • limit: Evaluate the limit as a variable approaches a specific value.
  • solve: Solve equations for a specified variable.

Numerical Methods

• riemann_sum: Calculate the Riemann sum of a definite integral using various methods (left, right, midpoint, trapezoidal).
• darboux_sum: Calculate the upper and lower Darboux sums for integral approximation.
• area: Calculate the area under a curve between two points.
• volume: Calculate the volume of a solid of revolution around the x - axis.

Mathematical Transforms

• laplace_transform: Calculate the Laplace transform of a function.
• fourier_transform: Calculate the Fourier transform of a function.
• z_transform: Calculate the Z - transform of a discrete - time function.

Financial Tools

• compound_interest: Calculate compound interest with custom compounding periods.
• present_value: Calculate the present value of future cash flows.
• npv: Calculate the Net Present Value (NPV) of a series of cash flows.
• black_scholes: Calculate the option price using the Black - Scholes model.
• option_greeks: Calculate option greeks (delta, gamma, vega, theta, rho).

Utility Functions

• logarithm: Calculate the logarithm with an arbitrary base.
• exponential: Calculate the exponential function (e^x).

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-calc-tools.git

# Navigate to the project directory
cd mcp-calc-tools

# Install dependencies
npm install
# or
pnpm install

💻 Usage Examples

Basic Usage

Start the MCP Server

# Make the script executable (if necessary)
chmod +x index.js

# Run the server
npm start
# or
node index.js

Integrate with AI Assistants

To use MCP Calc Tools with an AI coding assistant:

1. Configure your AI assistant (Cline/Roo Code) to use the MCP server.
2. Set the server URL to your running instance.
3. Now, the AI assistant can access all the mathematical tools.

An example request to calculate a derivative:

Calculate the derivative of x^2*sin(x)

🔧 Technical Details

Requirements

• Node.js v14 or higher
• Required packages:
  • genkit (^1.0.5)
  • genkitx - mcp (^1.0.5)
  • mathjs (^12.0.0)

Development

The project structure is as follows:

• index.js: The main server implementation containing all tool definitions.
• package.json: Project dependencies and script definitions.

📄 License

[Add your license information here]

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.