MCP Server POC

Name: MCP Server POC
Author: TarcisioPhilips

@TarcisioPhilips

关于 MCP Server POC

This project demonstrates how to create and use a Model Context Protocol (MCP) server that can provide custom tools and resources to AI assistants like Claude and others that support the MCP standard. The server includes: - Simple math operations (addition) - Dynamic greeting re

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

TarcisioPhilips

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-poc": {
      "command": "uv",
      "args": [
        "init"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Server POC?

A proof-of-concept implementation of a Model Context Protocol (MCP) server for AI assistant note-taking. It provides custom tools and resources to add, fetch, and summarize notes, and is designed for use with MCP-capable assistants like Claude and Cursor.

How to use MCP Server POC?

Install Python 3.11, clone the repo, set up a virtual environment, install dependencies, and run uv run mcp to start the server. For integration with Cursor, configure the absolute path to main.py in ~/.cursor/mcp.json.

Key features of MCP Server POC

add_note(note) tool: Appends a note to notes.txt
notes://latest resource: Retrieves the most recent note from the file
note_summary_prompt() prompt: Asks the AI to summarize all stored notes
All notes are persisted locally in a plain text file (notes.txt)
Uses stdio transport for communication with client applications

Use cases of MCP Server POC

Quickly capture and retrieve notes with an AI assistant
Prototype MCP server capabilities for note-management workflows
Experiment with custom tools, resources, and prompts in a local environment
Serve as a learning example for building MCP-based integrations

FAQ from MCP Server POC

What tools and resources does the server provide?

It offers the add_note tool to append a note, the notes://latest resource to fetch the latest note, and the note_summary_prompt to request a summary of all notes.

Where are notes stored?

Notes are saved in a file named notes.txt in the project root directory. The file is created automatically if it does not exist.

What runtime environment is required?

Python 3.11 and the packages listed in requirements.txt (including the MCP SDK) are needed. Optionally, the mcp[cli] extras can be installed.

How do I integrate the server with Cursor IDE?

Create or edit ~/.cursor/mcp.json (Windows: C:\Users\<username>\.cursor\mcp.json) with a JSON entry specifying the Python command and the absolute path to main.py, then restart Cursor.