Mcp Server

Mcp Server

What is Mcp Server about?

Mcp Server implements the Routine Model Context Protocol, acting as a lightweight process that receives JSON requests on stdin and returns responses on stdout. It allows MCP‑compatible clients to exchange context data with the Routine application.

How to use Mcp Server?

1. Ensure the Routine desktop application is running.
2. Install the package (it can be run directly with npx, no global install required):

   npx routine-mcp-server
   

3. For development, start the server with:

   yarn start
   

4. Configure your MCP client (e.g., Claude Desktop) to launch the server using:

   {
     "mcpServers": {
       "routine": {
         "command": "npx",
         "args": ["routine-mcp-server"]
       }
     }
   }
   

5. Interact by sending JSON payloads to the server’s stdin and reading responses from stdout.

Key Features

• Zero‑configuration start via npx.
• Works with any MCP‑compatible client through standard I/O streams.
• Simple development workflow with Yarn scripts (yarn build, yarn start).
• Fully typed TypeScript source compiled to dist/index.js for production use.

Use Cases

• Integrating Routine’s contextual data into AI assistants like Claude Desktop.
• Building custom MCP clients that need a local server bridge.
• Rapid prototyping of context‑aware workflows in local development environments.

FAQ

Q: Do I need to install Node.js globally? A: Yes, a recent Node.js version is required to run the server via npx.

Q: Can I run the server as a background service? A: Yes, start it with npx routine-mcp-server & or configure a process manager to launch the compiled dist/index.js.

Q: What environment variables are needed? A: No mandatory variables; only optional API keys if your custom logic requires external services.

Q: How do I debug the server? A: Use yarn start for a hot‑reloading development mode, or run the compiled file with node ./dist/index.js and inspect stdout logs.

Routine Model Context Protocol (MCP) Server

This is the Routine Model Context Protocol (MCP) server.

Usage

1. Run the Routine application for the MCP server to work.
2. Run this MCP server with npx routine-mcp-server or configure it in your favorite MCP client.

Claude Desktop

For Claude Desktop, refer to https://modelcontextprotocol.io/quickstart/user

In particular, your file claude_desktop_config.json should look something like that:

{
  "mcpServers": {
    "routine": {
      "command": "npx",
      "args": ["routine-mcp-server"]
    }
  }
}

Development

# Install dependencies
yarn

# Build the project
yarn build

Then install the MCP server:

• Command: full path to node executable
• Arguments: full path to ./dist/index.js

Claude Desktop

For Claude Desktop, refer to https://modelcontextprotocol.io/quickstart/user

In particular, your file claude_desktop_config.json should look something like that:

{
  "mcpServers": {
    "routine": {
      "command": "/absolute/path/to/bin/node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"]
    }
  }
}

Running the MCP Server (development)

# Start the server
yarn start

The server communicates via stdin/stdout, following the MCP protocol. You can interact with it by sending JSON requests to its stdin and reading responses from stdout.