mcp-quickstart

This MCP server is a quickstart setup that runs a TypeScript server using Bun to host an MCP endpoint. After cloning the repository and installing dependencies, you run the server.ts file with Bun to expose MCP endpoints that Claude or other MCP clients can query. The workflow described in the README guides you through wiring the running server to Claude's desktop configuration so that you can ask for weather data (or other capabilities provided by the server) through the MCP protocol. The key steps are to install Bun, clone the repo, install dependencies, locate the absolute path to the server file, and configure Claude with that path so requests are routed to your running MCP server.

The available tooling focuses on starting the server via Bun and integrating with Claude’s desktop app. The server.ts file is the entry point; when started with Bun, it serves the MCP endpoints defined in the project. Users interact with Claude to issue weather queries (as implied by the example) and receive structured model-context data in response via the MCP protocol.

Prerequisites:

• Git
• Bun (https://bun.sh/docs/installation)

Installation steps:

1. Clone the repository and install dependencies git clone https://github.com/dexaai/mcp-quickstart.git mcp-quickstart && cd mcp-quickstart && bun install

2. Ensure Bun is available and the server file is present

   • Confirm you have a server.ts at the repository root (or the path you intend to use).

3. Prepare the path to the server for Claude

   • Open a terminal and obtain the absolute path to the server.ts file: realpath server.ts
   • Copy the resulting path to use in Claude configuration (as shown in the README).

4. Configure Claude with the MCP server

   • Edit Claude’s desktop config and add the server entry using Bun to run server.ts. The example in the README demonstrates: { "mcpServers": { "weather-quickstart": { "command": "bun", "args": ["<path/to/repo>/server.ts"] } } }

5. Restart Claude and query the server via Claude’s interface.

Tips and notes:

• Ensure Bun is installed before attempting to run the server with bun.
• Use the absolute path to server.ts when configuring Claude to avoid path resolution issues.
• If the server fails to start, check that dependencies are installed (bun install) and that server.ts is accessible.
• If you modify server.ts or dependencies, re-run bun install if needed and restart Claude to pick up changes.
• This quickstart uses a specific example server named weather-quickstart; you can rename to reflect the actual service you expose.
• Environment variables are not specified in the README; if your server relies on API keys or endpoints, consider adding an env block in your MCP config or in Claude’s environment setup.
• Common issues include path mismatches, Bun version incompatibilities, and Claude configuration caching; always restart Claude after config changes.