Dune MCP Server

A Node.js implementation of a Model Context Protocol (MCP) server. This server provides example tools and resources that can be used with MCP-compatible clients like Claude Desktop.

Features

• Tools: Interactive functions that can be called by MCP clients
  • echo: Echo back input text
  • get_current_time: Get the current date and time
  • get_config: Get current server configuration (without sensitive data)
• Resources: Static or dynamic content that can be read by MCP clients
  • Server information and configuration

Installation

From npm (when published)

npm install -g dune-mcp-server

From source

1. Clone the repository:

git clone https://github.com/yourusername/dune-mcp-server.git
cd dune-mcp-server

2. Install dependencies:

npm install

3. Configure environment variables:

cp env.example .env
# Edit .env with your actual values

4. Build the project:

npm run build

Configuration

The server requires the following environment variables to be set:

• CLIENT_ID: Your API client ID
• CLIENT_SECRET: Your API client secret
• BASE_URL: The base URL for your API (e.g., https://api.example.com)
• PROJECT: Your project identifier

Environment Variables Setup

1. Using .env file (recommended for development):

   cp env.example .env

   Then edit .env with your actual values.

2. Using system environment variables:

   export CLIENT_ID="your_client_id"
   export CLIENT_SECRET="your_client_secret"
   export BASE_URL="https://api.example.com"
   export PROJECT="your_project"

3. Using Claude Desktop configuration:

   {
     "mcpServers": {
       "dune-mcp-server": {
         "command": "dune-mcp-server",
         "env": {
           "CLIENT_ID": "your_client_id",
           "CLIENT_SECRET": "your_client_secret",
           "BASE_URL": "https://api.example.com",
           "PROJECT": "your_project"
         }
       }
     }
   }

Usage

Running the server

npm start

Or if installed globally:

dune-mcp-server

Development

To run in development mode with automatic rebuilding:

npm run dev

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": {
    "dune-mcp-server": {
      "command": "node",
      "args": ["/path/to/dune-mcp-server/build/index.js"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "dune-mcp-server": {
      "command": "dune-mcp-server"
    }
  }
}

API

Tools

echo

Echoes back the provided text.

Parameters:

• text (string): The text to echo back

Example:

{
  "name": "echo",
  "arguments": {
    "text": "Hello, world!"
  }
}

get_current_time

Returns the current date and time in ISO format.

Parameters: None

Example:

{
  "name": "get_current_time",
  "arguments": {}
}

get_config

Returns the current server configuration (excluding sensitive data like client secret).

Parameters: None

Example:

{
  "name": "get_config",
  "arguments": {}
}

Response:

{
  "baseUrl": "https://api.example.com",
  "project": "your_project",
  "clientId": "your_client_id"
}

Resources

config://server-info

Returns information about the server including its capabilities and available tools.

Development

Project Structure

dune-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript (generated)
├── package.json          # Package configuration
├── tsconfig.json         # TypeScript configuration
├── LICENSE               # MIT License
└── README.md            # This file

Building

npm run build

Cleaning

npm run clean

Publishing to npm

1. Update the version in package.json
2. Update the repository URLs in package.json to point to your actual repository
3. Build the project: npm run build
4. Publish: npm publish

The prepublishOnly script will automatically clean and build the project before publishing.

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 the LICENSE file for details.

Links

• Model Context Protocol Documentation
• MCP SDK
• Claude Desktop