Skip to main content
Glama
quotable-api-mcp

quotable-api-mcp

by kurokeita

quotable-api-mcp

A Model Context Protocol (MCP) server built with mcp-framework.

Quick Start

# Install dependencies
npm install

# Build the project
npm run build

Related MCP server: Bootstrap MCP Server

Project Structure

quotable-api-mcp/
├── src/
│   ├── tools/        # MCP Tools
│   │   └── ExampleTool.ts
│   └── index.ts      # Server entry point
├── package.json
└── tsconfig.json

Adding Components

The project comes with an example tool in src/tools/ExampleTool.ts. You can add more tools using the CLI:

# Add a new tool
mcp add tool my-tool

# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

Tool Development

Example tool structure:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describes what your tool does";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

Publishing to npm

  1. Update your package.json:

    • Ensure name is unique and follows npm naming conventions

    • Set appropriate version

    • Add description, author, license, etc.

    • Check bin points to the correct entry file

  2. Build and test locally:

    npm run build
    npm link
    quotable-api-mcp  # Test your CLI locally
  3. Login to npm (create account if necessary):

    npm login
  4. Publish your package:

    npm publish

After publishing, users can add it to their claude desktop client (read below) or run it with npx


## Using with Claude Desktop

### Local Development

Add this configuration to your Claude Desktop config file:

**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "quotable-api-mcp": {
      "command": "node",
      "args":["/absolute/path/to/quotable-api-mcp/dist/index.js"]
    }
  }
}

After Publishing

Add this configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "quotable-api-mcp": {
      "command": "npx",
      "args": ["quotable-api-mcp"]
    }
  }
}

Building and Testing

  1. Make changes to your tools

  2. Run npm run build to compile

  3. The server will automatically load your tools on startup

Learn More

Available Tools

2 tools
health-checkD

HealthCheck tool description

Inputs: no named parameters.

random-quoteB

Get a random quote from the API

Inputs: tags, query, author.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one checks server health and the other fetches a quote. There is no overlap or ambiguity between them.

    Naming Consistency4/5

    Both tool names follow a consistent kebab-case pattern with two words. However, they use adjectives/nouns rather than a verb-noun convention, so the style is internally consistent but less typical.

    Tool Count3/5

    With only two tools, the server feels thin for a quotes API, but it could be intentionally minimal. The count is borderline and within the acceptable range for a single-purpose service.

    Completeness2/5

    The server only offers a random quote and a health check. Missing obvious operations like searching quotes, fetching by ID, or listing authors leaves significant gaps for a full-featured quotes API.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A template project for quickly building Model Context Protocol (MCP) servers using TypeScript and the official SDK. It includes pre-configured examples for tools and resources to help developers jumpstart their custom MCP server development.
      55 npm
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A starter template for building Model Context Protocol (MCP) servers with Node.js. It provides a foundational structure and an example tool to help developers quickly scaffold and deploy new MCP capabilities.
      8 npm
      1
      -