Overview
What is yt-mcp-server?
yt-mcp-server is a Model Context Protocol (MCP) server built with mcp-framework, providing a template project for developing MCP tools. It includes an example tool, a project structure, and instructions for adding custom tools, publishing to npm, and configuring with Claude Desktop.
How to use yt-mcp-server?
Clone the repository, run npm install to install dependencies, then npm run build to compile the TypeScript. For local use, add the server’s path to the Claude Desktop config file; after publishing, use npx yt-mcp-server. New tools can be scaffolded with mcp add tool <name>.
Key features of yt-mcp-server
- Developed using the mcp-framework for MCP compliance
- Includes an example tool in
src/tools/ExampleTool.ts - CLI command to add new tools (
mcp add tool) - Supports local development with Claude Desktop
- Can be published to npm for broader use
- Uses TypeScript and Zod schema validation
Use cases of yt-mcp-server
- Building custom MCP tools for AI assistants
- Learning how to structure and develop an MCP server
- Rapidly prototyping new tool integrations
- Publishing reusable tools to the npm ecosystem
FAQ from yt-mcp-server
What does yt-mcp-server actually do?
It is a starter template for creating MCP servers with mcp-framework. It does not come with pre‑built functionality beyond the example tool; developers extend it with their own tools.
How do I add a new tool?
Run mcp add tool my-tool in the project root, then implement the tool class in src/tools/ following the example structure.
How do I run yt-mcp-server locally?
Build the project with npm run build, then add a configuration entry in your Claude Desktop config file using the node command and the absolute path to dist/index.js.
Can yt-mcp-server be published to npm?
Yes. Update package.json, build and test locally with npm link, then run npm publish. After publishing, users can run it with npx yt-mcp-server.
What are the runtime requirements?
Node.js and npm. The project already includes the mcp-framework dependency, so no additional global installation is needed.
