Overview
MCP State Server is a TypeScript-based Model Context Protocol server that implements a simple notes system, demonstrating core MCP concepts through resources representing text notes with URIs and metadata.
To use the MCP State Server, install the dependencies, build the server, and configure it with Claude Desktop by adding the server config to the appropriate directory based on your operating system.
- Resources representing text notes with URIs and metadata. - Tools for creating new notes with required parameters. - Prompts for generating summaries of all stored notes.
- Creating and managing text notes for various applications.
- Summarizing notes for quick reference.
- Integrating with other applications that support MCP.
Add to your AI client
Use these steps to connect state-server MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-state-server-norisuke3": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-state-server-norisuke3"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-state-server-norisuke3": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-state-server-norisuke3"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-state-server-norisuke3": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-state-server-norisuke3"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-state-server-norisuke3": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-state-server-norisuke3"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-state-server-norisuke3": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-state-server-norisuke3"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-state-server-norisuke3": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-state-server-norisuke3"
]
}
}
}FAQ
What is the purpose of the MCP State Server?
The MCP State Server is designed to manage and summarize text notes using the Model Context Protocol.
How do I install the MCP State Server?
You can install it by running `npm install` and then build it using `npm run build`.
Can I use it with other applications?
Yes! It can be integrated with applications that support the Model Context Protocol.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2519,"uuid":"ca8b602f-978d-4e3f-b317-e4c53ff84897","name":"mcp-state-server","title":"state-server MCP Server","description":"my new repository","avatar_url":"https://avatars.githubusercontent.com/u/40401?v=4","created_at":"2025-03-13T08:33:57.183Z","updated_at":"2025-03-23T14:45:22.039Z","status":"created","author_name":"norisuke3","author_avatar_url":"https://avatars.githubusercontent.com/u/40401?v=4","tags":"mcp,state-server,notes-system","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/norisuke3/mcp-state-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-11 17:20:38\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]