mcptools — Claude MCP 必备工具中文教程

Install dependencies

npm install

Install dependencies and build

npm install && npm run build

Installation

Getting Started

The simplest way to start using MCP Tools is to connect to an MCP server and list available tools:

```bash

docker run -p 3001:3001 --rm -it tzolov/mcp-everything-server:v1

_Note:_ HTTP SSE currently supports only MCP protocol version 2024-11-05.

#### Streamable HTTP Transport (Recommended)

Uses streamable HTTP to communicate with an MCP server via JSON-RPC 2.0. This is the modern, recommended approach for connecting to remote servers that implement the MCP protocol. It supports both streaming responses and simple request/response patterns. This is the default transport for HTTP/HTTPS URLs.

Build the TypeScript code

npm run build

Example: Use the everything sample server

Examples with remote servers

mcp tools https://api.example.com/mcp mcp tools https://ne.tools ```

Benefits of Streamable HTTP: - Session Management: Supports stateful connections with session IDs - Resumability: Can reconnect and resume interrupted sessions (when supported by server) - Flexible Responses: Supports both streaming and direct JSON responses - Modern Protocol: Uses the latest MCP transport specification

Output: {"url":"https://api.example.com/mcp","headers":{"Authorization":"Bearer token"}}

Configurations are managed through a central registry in `$HOME/.mcpt/configs.json` with predefined aliases for:
- VS Code and VS Code Insiders
- Windsurf
- Cursor
- Claude Desktop and Claude Code

The system automatically displays server configurations in a colorized format grouped by source, showing command-line or URL information, headers, and environment variables.

`mcp configs scan` command looks for MCP server configurations in:
- Visual Studio Code
- Visual Studio Code Insiders
- Windsurf
- Cursor
- Claude Desktop

Example Output:

Claude Desktop Proxy (stdio): mcp proxy start

My Files (stdio): npx -y @modelcontextprotocol/server-filesystem ~/ ```

Examples

Basic Usage

List tools from a filesystem server:

mcp tools npx -y @modelcontextprotocol/server-filesystem ~

Call a tool with pretty JSON output:

mcp call read_file --params '{"path":"README.md"}' --format pretty npx -y @modelcontextprotocol/server-filesystem ~

Use the guard mode to filter available tools:

```bash

Streamable HTTP Usage

Create and run a local streamable HTTP server:

```bash

Example with authentication headers (when supported)

mcp tools https://authenticated-mcp-server.com ```

Transport Options

MCP Tools supports multiple transport methods for communicating with MCP servers:

Stdio Transport

Uses stdin/stdout to communicate with an MCP server via JSON-RPC 2.0. This is useful for command-line tools that implement the MCP protocol.

mcp tools npx -y @modelcontextprotocol/server-filesystem ~

HTTP SSE Transport

Uses HTTP and Server-Sent Events (SSE) to communicate with an MCP server via JSON-RPC 2.0. This is useful for connecting to remote servers that implement the legacy MCP protocol. Transport is automatically detected when the URL ends with /sse.

```bash mcp tools http://localhost:3001/sse

LLM Apps Config Management

MCP Tools provides a powerful configuration management system that helps you work with MCP server configurations across multiple applications:

🚧 This works only on macOS for now.

```bash

Scan for MCP server configurations across all supported applications

mcp configs scan

List all configurations (alias for configs view --all)

mcp configs ls

View specific configuration by alias

mcp configs view vscode

Add or update a server in a configuration

mcp configs set vscode my-server npm run mcp-server mcp configs set cursor my-api https://api.example.com/mcp --headers "Authorization=Bearer token"

Add to multiple configurations at once

mcp configs set vscode,cursor,claude-desktop my-server npm run mcp-server

Remove a server from a configuration

mcp configs remove vscode my-server

Create an alias for a custom config file

mcp configs alias myapp ~/myapp/config.json

Synchronize and merge configurations from multiple sources

mcp configs sync vscode cursor --output vscode --default interactive

Convert a command line to MCP server JSON configuration format

mcp configs as-json mcp proxy start

Convert a URL to MCP server JSON configuration format

mcp configs as-json https://api.example.com/mcp --headers "Authorization=Bearer token"

Register an inline command as an MCP tool with optional parameter

mcpt proxy tool add_operation "Adds a and b with optional result msg" "a:int,b:int,[msg:string]" -e 'echo "$msg$a + $b = $(($a+$b))"'

Get values from environment variables

if [ -z "$a" ] || [ -z "$b" ]; then echo "Error: Missing required parameters 'a' or 'b'" exit 1 fi

Create a read-only environment

mcp guard --deny tools:write_*,delete_*,create_*,move_* npx -y @modelcontextprotocol/server-filesystem ~ ```

Get values from environment variables

if [ -z "$a" ] || [ -z "$b" ]; then echo "Error: Missing required parameters 'a' or 'b'" exit 1 fi result=$(($a + $b)) echo "The sum of $a and $b is $result" EOF

Web Interface

MCP Tools provides a web interface for interacting with MCP servers through a browser-based UI:

```bash

Start a web interface for a filesystem server on default port (41999)

mcp web npx -y @modelcontextprotocol/server-filesystem ~

Create a project with a specific SDK (currently only TypeScript/ts supported)

mcp new tool:calculate --sdk=ts

Connect to local SSE server (adjust URL based on your server's SSE endpoint)

mcp tools http://localhost:3000/sse

Create a project with specific components

mcp new tool:calculate resource:file prompt:greet

Script Integration

Using the proxy mode with a simple shell script:

```bash