ghostserver (Adam Scott Thomas)

MCPAI代理

提供方 adam-scott-thomas

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 ClaudeCursorWindsurfVS Code
查看接入方式

GhostServer是一个自托管的MCP服务器,可将任何AI工具连接到您的真实账户,确保令牌不会离开您的机器。

一句话选型结论

按资料字段整理

ghostserver (Adam Scott Thomas) 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude、Cursor、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 19 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量19暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

自托管Python本地部署MCP协议AI工具集成本地代理多服务支持

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install ghostserver

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ghostserver (Adam Scott Thomas)当前 19 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方adam-scott-thomas上游标注的维护方 adam-scott-thomas
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.0 KB
来自项目仓库与上游目录的原文,未做删改

Ghost服务器

自托管MCP服务器,将任何AI工具连接到您的真实账户。你的代币永远不会离开你的机器。

适用于Claude Code、Cursor、VS Code Copilot、Windsurf和任何兼容MCP的客户端。

为什么

每个“MCP服务器”都有一个指向其他人云的设置向导,或者锁定到一个AI供应商。GhostServer在本地运行,将凭据存储在您自己的保险库中,并使用标准的MCP协议,因此任何客户端都可以使用它。

21工具,5服务

服务 工具
GitHub 列出仓库、创建问题、列出/获取PR、搜索代码
Gmail 搜索、阅读、发送、列出标签
谷歌日历 列出事件、创建事件、忙/闲、获取事件
云耀 列出区域、DNS记录、创建DNS、列出Workers
亚马逊云服务 S3存储桶/对象、EC2实例、CloudWatch指标

安装```bash

pip install ghostserver


或来源:```bash
git clone https://github.com/adam-scott-thomas/ghostserver.git
cd ghostserver
pip install -e ".[dev]"

快速开始

1.配置```bash

cp ghostserver.toml.example ghostserver.toml


编辑 `ghostserver.toml` --启用所需的服务并设置凭据引用。

### 2.存储凭据

GhostServer支持三个凭据后端:

**环境变量** (最简单):```toml
[server]
credential_backend = "env"

[github]
enabled = true
token_ref = "GITHUB_TOKEN"
``````bash
export GITHUB_TOKEN="ghp_your_token_here"

凭据文件 (无环境污染):```toml
[server]
credential_backend = "file"
credential_file = "~/.ghostserver/credentials"

[github]
enabled = true
token_ref = "GITHUB_TOKEN"
``````

~/.ghostserver/credentials

GITHUB_TOKEN=ghp_your_token_here
CLOUDFLARE_TOKEN=your_cf_token


**1Password命令行界面** (最安全):```toml
[server]
credential_backend = "op"

[github]
enabled = true
token_ref = "op://Development/GitHub PAT/credential"

自动检测 (默认):尝试1Password,然后是凭据文件,然后是env-vars。

3.谷歌服务(一次性设置)

Gmail和谷歌日历需要OAuth。运行安装向导一次:```bash
python -m ghostserver.google_auth


这将打开您的浏览器,获得同意,并将刷新令牌存储在您选择的后端。

### 4.连接到您的AI工具

**克劳德代码:**```bash
claude mcp add --transport stdio ghostserver -- python -m ghostserver

光标/VS代码:
添加到MCP设置中:```json
{
"ghostserver": {
"command": "python",
"args": ["-m", "ghostserver"]
}
}


**任何MCP客户端(stdio):**```bash
python -m ghostserver

建筑```

Your AI Tool (Claude Code, Cursor, etc.)
|
| MCP protocol (stdio)
|
v
GhostServer (local process)
|
|-- spine (frozen config registry)
|-- gate (per-service rate limiting + enabled checks)
|-- token store (pluggable: 1Password / env / file)
|
|-- GitHub adapter ──> api.github.com
|-- Gmail adapter ──> gmail.googleapis.com
|-- Calendar adapter ──> googleapis.com/calendar
|-- Cloudflare adapter ──> api.cloudflare.com
|-- AWS adapter ──> boto3 (local credentials)


每个适配器都是一个文件。登机口强制执行每次服务的费率限制。Spine提供了冻结配置单例,因此适配器不会传递对象。

## 添加自己的适配器

创建 `src/ghostserver/adapters/myservice.py`:```python
from fastmcp import FastMCP
from spine import Core
from ghostserver.gate import check_gate

SERVICE = "myservice"
server = FastMCP("My Service")

@server.tool
async def myservice_do_thing(param: str) -> dict:
"""Description for the AI client."""
check_gate(SERVICE)
tokens = Core.instance().get("tokens")
token = tokens.get(Core.instance().get("config").myservice.token_ref)
# ... call your API ...
return {"result": "done"}

将服务配置添加到 config.py,将模块名称添加到 adapters/__init__.py,完成。提交PR。

发展```bash

git clone https://github.com/adam-scott-thomas/ghostserver.git
cd ghostserver
pip install -e ".[dev]"
pytest -v
```

许可证

Apache 2.0

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ghostserver (Adam Scott Thomas) 怎么安装?

在客户端按下面的安装命令接入:pip install ghostserver。装完在客户端配置里引用同一个包或端点。

ghostserver (Adam Scott Thomas) 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ghostserver (Adam Scott Thomas) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ghostserver (Adam Scott Thomas) 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

ghostserver (Adam Scott Thomas) 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ghostserver (Adam Scott Thomas) 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 自托管、Python、Claude。具体工具清单以官方文档为准。

ghostserver (Adam Scott Thomas) 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

ghostserver (Adam Scott Thomas) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。