npm package: @sri01729/mcp-server
Description: Maaya MCP Server - A production-ready Model Context Protocol server with useful tools
Author: Maaya Team
Latest version: 1.0.11

# Maaya MCP Server

A production-ready Model Context Protocol (MCP) server with useful tools for AI agents and developers.

## 🚀 Features

- **Production Ready**: Deployed on Cloudflare Workers
- **Multiple Tools**: 5 useful tools for AI agents
- **Easy Integration**: Simple setup for Cursor, Claude, and other MCP clients
- **TypeScript**: Fully typed for better development experience

## 📦 Installation

### For Cursor IDE

1. **Install the package globally:**

   ```bash
   npm install -g @maaya/mcp-server
   ```

2. **Add to your Cursor MCP configuration** (`~/.cursor/mcp.json`):

   ```json
   {
     "mcpServers": {
       "maaya-mcp": {
         "command": "maaya-mcp"
       }
     }
   }
   ```

3. **Restart Cursor** and enjoy your new tools!

### For Other MCP Clients

1. **Install the package:**

   ```bash
   npm install @maaya/mcp-server
   ```

2. **Use the binary:**
   ```bash
   npx maaya-mcp
   ```

## 🛠️ Available Tools

### 1. `ping`

Test connectivity and get a response.

```json
{
  "message": "Hello from AI!"
}
```

### 2. `echo`

Echo back any input parameters.

```json
{
  "text": "Any data you want to echo back"
}
```

### 3. `calculate`

Perform mathematical calculations.

```json
{
  "expression": "2 + 3 * 4"
}
```

### 4. `weather`

Get mock weather data for any location.

```json
{
  "location": "San Francisco",
  "unit": "celsius"
}
```

### 5. `analyze_text`

Analyze text and provide statistics.

```json
{
  "text": "Your text to analyze here"
}
```

## 🌐 Production Endpoint

Your MCP server is live at:
**https://maaya-mcp-server.srinivasalahari1728.workers.dev**

### API Endpoints:

- `GET /health` - Health check
- `GET /mcp/tools` - List available tools
- `POST /mcp/test` - Test tool execution

## 🔧 Development

### Local Development

```bash
# Clone the repository
git clone https://github.com/sri01729/Maaya-MCP-Server.git
cd Maaya-MCP-Server

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Deploy to Cloudflare Workers
npm run deploy
```

### Environment Variables

Create a `.env` file with:

```env
NODE_ENV=development
PORT=3000
LOG_LEVEL=info
CORS_ORIGIN=*
```

## 📝 Usage Examples

### In Cursor IDE

Once configured, you can use the tools directly in Cursor:

1. **Test connectivity:**

   ```
   Use the ping tool to test if the server is working
   ```

2. **Calculate something:**

   ```
   Calculate the result of 15 * 23 + 7
   ```

3. **Get weather:**
   ```
   Get the weather for Tokyo in fahrenheit
   ```

### Programmatic Usage

```javascript
// Example: Using the MCP server programmatically
const response = await fetch(
  'https://maaya-mcp-server.srinivasalahari1728.workers.dev/mcp/test',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      tool: 'calculate',
      params: { expression: '2 + 3 * 4' },
    }),
  }
);

const result = await response.json();
console.log(result);
```

## 🤝 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

MIT License - see LICENSE file for details.

## 🆘 Support

- **Issues**: [GitHub Issues](https://github.com/sri01729/Maaya-MCP-Server/issues)
- **Documentation**: [MCP Protocol](https://modelcontextprotocol.io/)

## 🔗 Links

- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Cursor IDE](https://cursor.sh/)
- [Cloudflare Workers](https://workers.cloudflare.com/)