What is Datastax Mcp Monsters

datastax-mcp-monsters is a Model Context Protocol (MCP) server built with TypeScript that facilitates a simple notes system for looking up monster data. It showcases core MCP concepts through resources, tools, and prompts related to text notes.

Use cases

Use cases for datastax-mcp-monsters include creating a personal note-taking application, developing educational software that requires summarization of notes, or integrating with other systems that need to manage and retrieve text-based information efficiently.

How to use

To use datastax-mcp-monsters, install the necessary dependencies using ‘pnpm install’, build the server with ‘pnpm run build’, and configure the server settings in the ‘claude_desktop_config.json’ file. Ensure to provide your Datastax Astra DB API endpoint and token for proper functionality.

Key features

Key features include the ability to list and access notes via ‘note://’ URIs, create new notes with the ‘create_note’ tool, and generate summaries of stored notes using the ‘summarize_notes’ prompt. Each note contains a title, content, and metadata.

Where to use

datastax-mcp-monsters can be used in applications that require a simple note-taking system, particularly in educational tools, documentation systems, or any context where quick access to structured text notes is beneficial.

weather-server MCP Server

A Model Context Protocol server

This is a TypeScript-based MCP server that implements a simple notes system. It demonstrates core MCP concepts by providing:

• Resources representing text notes with URIs and metadata
• Tools for creating new notes
• Prompts for generating summaries of notes

Features

Resources

• List and access notes via note:// URIs
• Each note has a title, content and metadata
• Plain text mime type for simple content access

Tools

• create_note - Create new text notes
  • Takes title and content as required parameters
  • Stores note in server state

Prompts

• summarize_notes - Generate a summary of all stored notes
  • Includes all note contents as embedded resources
  • Returns structured prompt for LLM summarization

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

Load up a Datastax collection with the monster data.

Get the Datastax Astra DB API endpoint and token from the Astra DB UI.

Run pnpm install to install the dependencies.

Run pnpm run build to build the server.

Edit the claude_desktop_config.json file to add the server config:

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

{
  "mcpServers": {
    "monster-server": {
      "name": "monster-server",
      "command": "[path to node]",
      "args": [
        "[path to this repo]/build/index.js"
      ],
      "env": {
        "ASTRA_DB_API_ENDPOINT": "https://[dbname].apps.astra.datastax.com",
        "ASTRA_DB_APPLICATION_TOKEN": "[token]"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

You will need to set the ASTRA_DB_API_ENDPOINT and ASTRA_DB_APPLICATION_TOKEN environment variables in the inspector UI.