Skip to main content
Glama
elimyliu

timeverse-command-mcp

by elimyliu

timeverse-command-mcp

跨平台执行 shell / Python / Node 命令的 MCP (Model Context Protocol) Server

PyPI Python License


它能做什么?

让任意支持 MCP 的 AI 客户端(Timeverse Studio、Claude Desktop、Cursor、Continue 等)通过三个工具直接操作你的本地机器

工具

作用

适用平台

bash

执行 shell 命令

macOS / Linux / Windows

python

执行 Python 代码片段

全平台

node

执行 JavaScript 代码片段

全平台

典型用法(让 Claude 帮你做):

"用 bash 看一下 /tmp 目录下最大的 5 个文件"
"用 python 算一下 1+2+...+100"
"用 node 把这个 JSON 解析后告诉我 user.name"

Related MCP server: Terminal MCP Server

安装

方式 1:pip(推荐)

pip install timeverse-command-mcp

安装完成后会得到一个 timeverse-command-mcp 命令。

方式 2:源码安装(开发用)

git clone https://github.com/elimyliu/timeverse-command-mcp.git
cd timeverse-command-mcp
pip install -e ".[dev]"

接入 Claude Desktop

编辑 Claude Desktop 配置文件(位置见下表):

操作系统

配置路径

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

加入以下内容:

{
  "mcpServers": {
    "timeverse-command": {
      "command": "timeverse-command-mcp",
      "args": [],
      "env": {}
    }
  }
}

重启 Claude Desktop,工具列表中会出现 bash / python / node 三个工具。

详细配置说明、Cursor / Continue / Cline 等其他客户端的接入方式,请参考 docs/USAGE.md

Python API

除了作为 MCP Server,本包也可以作为 Python 库使用:

import asyncio
from timeverse_command import AsyncCommandSession

async def main():
    session = AsyncCommandSession(
        tool_call_id="demo-1",
        command="echo hello && echo world",
        tool_name="bash",
    )

    async for chunk in session.run():
        if chunk["stream"] == "stdout":
            print(f"[out] {chunk['delta']}")
        elif chunk["stream"] == "exit":
            print(f"[exit] code={chunk['exit_code']} status={chunk['status']}")

asyncio.run(main())

输出:

[out] hello
[out] world
[exit] code=0 status=success

更多 API(取消、全局执行器等)见 docs/USAGE.md


开发

# 克隆
git clone https://github.com/elimyliu/timeverse-command-mcp.git
cd timeverse-command-mcp

# 安装依赖(含 dev 工具)
pip install -e ".[dev]"

# 运行测试
pytest

# 代码风格
ruff check src/
ruff format src/

# 类型检查
mypy src/

协议

  • MCP 传输: stdio(标准)

  • 不依赖任何私有扩展,可在所有支持 MCP stdio 的客户端中使用

  • 增强能力(流式 / 取消 / 危险确认)由 TimeVerse Studio 客户端专属提供,其他客户端以"基础能力"运行


许可证

MIT © TimeVerse Studio

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/elimyliu/timeverse-command-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server