About yapi-mcp-server
A TypeScript MCP server implementing a simple text notes system. It is suited to clients that need to create notes, access them as resources, or prepare their contents for summarization.
Key features
- 01Create text notes with title and content
- 02List and read notes through note:// URIs
- 03Attach metadata to notes
- 04Provide a summary prompt with note contents
Use cases
- 01Save notes for later access
- 02Read note content through an MCP resource
- 03Prepare stored notes for LLM summarization
MCP support
Exposes notes as resources, creation as a tool, and a summarization prompt to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEyapi-mcp-service 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
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"yapi-mcp-service": {
"command": "/path/to/yapi-mcp-service/build/index.js"
}
}
}
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.