返回 MCP 目录
public公开dns本地运行

humanmcp

humanmcp是一个手动操作的MCP服务器项目,用户需要手动读取请求并写入响应。

article

README

🚀 项目介绍

这是一个关于MCP服务器的玩笑项目,为大家带来别样的体验。

🚀 快速开始

✨ 主要特性

此MCP服务器是 100% 手动操作,充满了趣味性和独特性。

📦 安装指南

    1. Releases 下载服务器二进制文件。
    1. 将服务器添加到MCP主机的设置中。
// 示例:VSCode 设置
"mcp": {
  "inputs": [],
  "servers": {
    "human-mcp": {
      "command": "path/to/humanmcp/executable",
      "args": [
      ],
      "env": {}
    }
  }
}

💻 使用示例

基础用法

这个MCP服务器是 100% 手动操作。祝你好运。

  • 你从 in.txt 中读取请求。
  • 你将响应写入到 out.txt 中。
# 监控客户端的请求
$ tail -f in.txt
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"roots":{"listChanged":true}},"clientInfo":{"name":"Visual Studio Code","version":"1.99.2"}}}
{"method":"notifications/initialized","jsonrpc":"2.0"}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get-japan-forecast","arguments":{"location":"Tokyo"}}}

高级用法

# 将响应发送回客户端
$ echo '{"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"humanmcp","version":"1.0.0","capabilities":{"resources":{},"tools":{}}}},"jsonrpc":"2.0","id":1}' > out.txt
$ echo '{"result":{"tools":[{"name":"get-japan-forecast","description":"Get weather forecast","inputSchema":{"type":"object","properties":{"location":{"type":"string","description":"location name"}},"required":["location"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}]},"jsonrpc":"2.0","id":2}' > out.txt
$ echo '{"result":{"content":[{"type":"text","text":"sunny"}]},"jsonrpc":"2.0","id":3}' > out.txt

架构图

humanmcp架构图

(当然,这是一个玩笑项目 😅 )

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端