MCP ExplorerExplorer

Test Python Mcp Server

@jtorreggianion 3 days ago
0 MIT
FreeCommunity
AI Systems

Overview

What is Test Python Mcp Server

The MCP server is a project designed for managing a simple note storage system. It allows users to create, access, and summarize notes using a custom URI scheme (note://), enabling efficient note management and retrieval.

Use cases

This server can be used for personal note-taking, organizing information for projects, collaborative work among team members, and generating summaries from stored notes for quick reference or review.

How to use

To use the server, install it by configuring the appropriate settings in the Claude Desktop application, add notes using the ‘add-note’ tool, and create summaries of all notes with the ‘summarize-notes’ prompt, optionally specifying the desired detail level.

Key features

Key features of the server include the custom note:// URI scheme for directly accessing notes, a user-friendly prompt system for summarizing notes with customizable detail levels, and a straightforward method to add new notes, keeping the server state updated.

Where to use

The MCP server can be effectively used in various settings such as personal productivity applications, educational tools for students, knowledge management systems in businesses, and collaborative environments where team members need shared note access.

Content

test-server MCP server

A MCP server project

Components

Resources

The server implements a simple note storage system with:

  • Custom note:// URI scheme for accessing individual notes
  • Each note resource has a name, description and text/plain mimetype

Prompts

The server provides a single prompt:

  • summarize-notes: Creates summaries of all stored notes
    • Optional “style” argument to control detail level (brief/detailed)
    • Generates prompt combining all current notes with style preference

Tools

The server implements one tool:

  • add-note: Adds a new note to the server
    • Takes “name” and “content” as required string arguments
    • Updates server state and notifies clients of resource changes

Configuration

[TODO: Add configuration details specific to your implementation]

Quickstart

Install

Claude Desktop

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

Development/Unpublished Servers Configuration ``` "mcpServers": { "test-server": { "command": "uv", "args": [ "--directory", "/Users/jtorreggiani/organizer/work/open-source/create-python-server/test-server", "run", "test-server" ] } } ```
Published Servers Configuration ``` "mcpServers": { "test-server": { "command": "uvx", "args": [ "test-server" ] } } ```

Development

Building and Publishing

To prepare the package for distribution:

  1. Sync dependencies and update lockfile:
uv sync
  1. Build package distributions:
uv build

This will create source and wheel distributions in the dist/ directory.

  1. Publish to PyPI:
uv publish

Note: You’ll need to set PyPI credentials via environment variables or command flags:

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

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging
experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /Users/jtorreggiani/organizer/work/open-source/create-python-server/test-server run test-server

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Tools

No tools

Comments