connect-mcp-server

What is connect-mcp-server?

connect-mcp-server is a Model Context Protocol (MCP) server built with mcp-framework. It is designed for developers to create, test, and deploy custom MCP tools that can be integrated with MCP clients such as Claude Desktop.

How to use connect-mcp-server?

Install dependencies with npm install, build with npm run build, and then run the server directly or via npx. To use with Claude Desktop, add its configuration to the claude_desktop_config.json file, pointing either to the local built script or the published npm package.

Key features of connect-mcp-server

• Built with the mcp-framework for easy MCP tool development.
• Includes an example tool (ExampleTool) for rapid prototyping.
• Supports adding new tools via CLI: mcp add tool <tool-name>.
• Automatically discovers and loads tools from src/tools/ on startup.
• Can be published to npm and run with npx.
• Simple integration with Claude Desktop via JSON configuration.

Use cases of connect-mcp-server

• Creating custom MCP tools for data processing or transformation.
• Building an API client tool to interact with external services.
• Developing a file handling tool for local file system operations.
• Integrating with Claude Desktop as a local or published MCP server.

FAQ from connect-mcp-server

How do I add a new tool?

Use the CLI command mcp add tool my-tool from the project's root directory. Example tools include data-processor, api-client, and file-handler.

How do I run connect-mcp-server with Claude Desktop?

Add the server configuration to your Claude Desktop config file. For local development, use the absolute path to dist/index.js. After publishing to npm, use "command": "npx", "args": ["connect-mcp-server"].

How do I publish connect-mcp-server to npm?

Update package.json with a unique name, version, description, and correct bin entry. Run npm run build, then npm publish. Users can then run it with npx connect-mcp-server.

What are the runtime requirements?

Node.js is required. The project is written in TypeScript and must be built with npm run build before use.

Where do tools live in the project?

Tools are placed in the src/tools/ directory and are automatically loaded by the server on startup. The entry point is src/index.ts.