Enables publishing the MCP server as an npm package that can be installed and run by other users
Provides a TypeScript-based framework for developing MCP tools with type safety and modern language features
Uses Zod schema validation for defining tool input parameters and ensuring proper data validation
scenario-word
A Model Context Protocol (MCP) server built with mcp-framework.
Quick Start
Related MCP server: OmniFocus-MCP
Project Structure
Adding Components
The project comes with an example tool in src/tools/ExampleTool.ts. You can add more tools using the CLI:
Tool Development
Example tool structure:
Publishing to npm
Update your package.json:
Ensure
nameis unique and follows npm naming conventionsSet appropriate
versionAdd
description,author,license, etc.Check
binpoints to the correct entry file
Build and test locally:
npm run build npm link scenario-word # Test your CLI locallyLogin to npm (create account if necessary):
npm loginPublish your package:
npm publish
After publishing, users can add it to their claude desktop client (read below) or run it with npx
After Publishing
Add this configuration to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Building and Testing
Make changes to your tools
Run
npm run buildto compileThe server will automatically load your tools on startup