mcp_starter_cli

by Sumedh1599

311 downloads
Not rated
GitHub

About

CLI tool to scaffold, run, and test MCP servers locally with Node.js or Python, integrated with Claude and OpenAI key injection and auto-link to Claude Desktop.

Details

Author
Sumedh1599
Downloads
311
Categories
Developer Tools, AI

- Scaffold new MCP server projects for Node.js or Python
- Dynamically inject OpenAI or Claude API keys
- Real-time server logging with live error display
- Auto-linking to Claude Desktop for local testing
- Built-in support for linting and TypeScript transpilation
- Simple global installation via npm or Yarn

Install globally via npm install -g mcp_starter_cli or yarn global add mcp_starter_cli. Use mcp_starter_cli scaffold to create a new project, mcp_starter_cli run to start the server, mcp_starter_cli config set to inject API keys, and mcp_starter_cli logs to monitor server logs in real time.

mcp_starter_cli

Introduction

mcp_starter_cli is a powerful Command Line Interface (CLI) tool designed to simplify the process of scaffolding, running, and testing MCP servers locally using Node.js or Python. It integrates seamlessly with Claude and OpenAI API keys for enhanced functionality. Additionally, it supports auto-linking to Claude Desktop for local agent testing and includes features like live error display and support for auto-linting and TypeScript transpilation.

Features

- CLI Interface: Easily scaffold, run, and deploy MCP servers.
- API Key Injection: Dynamically inject OpenAI or Claude API keys as needed.
- Server Logging & Error Display: Monitor server logs in real-time with live error display for quick debugging.
- Claude Desktop Integration: Automatically link to Claude Desktop for local agent testing.
- Auto-linting and TS Transpilation: Built-in support for linting JavaScript/TypeScript code and transpiling TypeScript.

Installation Instructions

Prerequisites

Ensure you have Node.js installed on your system. You can download it from nodejs.org.

Install mcp_starter_cli

You can install the CLI tool globally using npm:

npm install -g mcp_starter_cli

Alternatively, if you prefer to use Yarn:

yarn global add mcp_starter_cli

Usage Examples

Scaffold a New Project

To create a new MCP server project, run:

mcp_starter_cli scaffold my-mcp-project --template nodejs

or for Python projects:

mcp_starter_cli scaffold my-python-mcp-project --template python

Run the Server Locally

Navigate to your project directory and start the server:

cd my-mcp-project
mcp_starter_cli run

For Python:

cd my-python-mcp-project
mcp_starter_cli run

Inject API Keys

To inject OpenAI or Claude API keys, use:

mcp_starter_cli config set openai-key YOUR_OPENAI_API_KEY
mcp_starter_cli config set claude-key YOUR_CLAUDE_API_KEY

View Server Logs

Monitor the server logs in real-time with live error display:

mcp_starter_cli logs

API Documentation

For detailed API documentation and advanced usage, please refer to the API Docs.

License

mcp_starter_cli is open-source software licensed under the MIT License. For more details, see the LICENSE file.

---

Feel free to contribute to this project or report any issues via our GitHub repository. Happy coding! 🚀

GitHub Repository


This README provides a comprehensive overview of the mcp_starter_cli tool, including its features, installation instructions, usage examples, and licensing information. Make sure to replace placeholders like your-repo with your actual GitHub repository details.

⚠️ Development Status

This library is currently in early development. Some tests may be failing with the following issues:

```

Contributions to fix these issues are welcome! Please submit a pull request if you have a solution.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.