MCP POC

MCP POC is an MCP server that provides a modular Node.js and TypeScript proof-of-concept template for integrating custom tools with Model Context Protocol clients like Claude Desktop. Developers building initial MCP prototypes or learning protocol architecture use this implementation to explore tool registration, validation schemas, and structured error handling. The server connects host applications directly to basic runtime utilities via local processes. By adopting a separated resolver and use-case structure, the project demonstrates how to organize clean integrations using Zod input validation and standard protocol handlers. The included tools allow clients to generate formal or informal greetings in Spanish, calculate arithmetic expressions like addition and division, and retrieve formatted system timestamps across multiple output styles. Developers can also use the integrated Vitest test suite and testing workflows to verify custom tool behavior, error responses, and parameter parsing prior to deploying complex services.

Category: Other & General Purpose

Tags: nodejs, poc, template, typescript

Visit MCP POC

How to install and configure MCP POC

1. Run the server directly using npx or build it locally: bash git clone https://github.com/sokardys/mcp-poc cd mcp-poc npm install npm run build 2. Open your Claude Desktop configuration file: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json 3. Add the server entry under the mcpServers object: json { "mcpServers": { "mcp-poc": { "command": "npx", "args": ["@sokardys/mcp-poc@latest"] } } } If testing a local build, set command to node and pass the full path to build/index.js in args. 4. Restart Claude Desktop to load the server.

What you can do with MCP POC

• Performing reliable arithmetic calculations inside Claude conversations using the calculator tool for basic operations like division and multiplication. - Generating structured Spanish greeting messages in formal or informal tones based on dynamic user input and parameters. - Fetching the host system date and time in short, long, or ISO formats directly through Claude Desktop prompts. - Learning how to structure modular TypeScript MCP servers with separate resolvers, use-case handlers, and Zod input schemas. - Testing MCP tools and error responses locally using Vitest and mcpgod command-line test suites.

Key facts

• https://github.com/sokardys/mcp-poc
• Other & General Purpose
• nodejs, poc, template, typescript

Part of MCP Servers

How do I install MCP POC?

You can run MCP POC directly through npx by pointing your Claude Desktop configuration to @sokardys/mcp-poc@latest. Alternatively, you can clone the GitHub repository, run npm install, execute npm run build, and register the resulting build/index.js file using Node in your Claude Desktop configuration file.

What can MCP POC do?

MCP POC serves as a demonstration server providing three core tools. It includes greeting for producing formal or informal Spanish greetings, calculator for executing addition, subtraction, multiplication, and division, and get_current_datetime for returning current system timestamps formatted in short, long, or ISO strings.

Which MCP clients work with MCP POC?

MCP POC is designed and tested for compatibility with Claude Desktop. Because it conforms to the standard Model Context Protocol over standard input and output, it can also be inspected and operated using MCP development utilities like mcpgod or other standard MCP client interfaces.

Is MCP POC open source?

Yes, MCP POC is open-source software distributed under the MIT license. You can inspect the full source code, modify tools, and review licensing details directly in the official GitHub repository at https://github.com/sokardys/mcp-poc.