MCP Server Opensearch

🚀 MCP Server OpenSearch Version

A simple server project based on the MCP protocol.

🚀 Quick Start

📦 Installation

Using Claude Desktop

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

✨ Features

Resources

The server implements a simple note storage system with the following features:

• A custom note:// URI scheme for accessing individual notes.
• Each note resource includes a name, description, and text/plain MIME type.

Prompt Statements

The server provides a prompt statement:

• summarize-notes: Create a summary of all stored notes.
  • An optional "style" parameter to control the level of detail (concise/detailed).
  • Generate a prompt statement containing the content of all current notes based on style preferences.

Tools

The server implements a tool:

• add-note: Add a new note to the server.
  • Accept "name" and "content" as required string parameters.
  • Update the server state and notify the client of resource changes.

📚 Documentation

Configuration

[To be supplemented: Add implementation-specific configuration details]

Development

Build and Publish

To prepare the distribution package:

1. Synchronize dependencies and update the lock file:

uv sync

2. Build the package distribution version:

uv build

This will create source code and wheel distribution versions in the dist/ directory.

3. Publish to PyPI:

uv publish

Note: You need to set PyPI credentials via environment variables or command-line parameters:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since the MCP server runs through standard input and output, debugging can be challenging. For the best debugging experience, we highly recommend using MCP Inspector.

You can start MCP Inspector with the following command (assuming npm is installed):

npx @modelcontextprotocol/inspector uv --directory /Users/gowtham/Gowtham/Projects/mcp-server-opensearch run mcp-server-opensearch

After starting, the Inspector will display a URL that you can access in your browser to start debugging.