pine-mcp-server

MCP浏览器工具

提供方 19PINE-AI

浏览器工具 Streamable HTTP OAuth 授权 社区 / 第三方 ClaudeCursorCodexZed
查看接入方式

Pine Assistant MCP is an MCP plugin/remote server that brings the Pine AI personal assistant into MCP clients, enabling developers to use AI coding agents such as Codex, Claude Code, and Cursor to handle real-world tasks in natural language while tracking progress through browser-based OAuth authorization.

一句话选型结论

按资料字段整理

pine-mcp-server 属于浏览器工具类 MCP 服务器,Streamable HTTP,OAuth 授权,可直接接入 Claude、Cursor、Codex 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式Streamable HTTP 鉴权OAuth 授权 部署方式远程部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

Blend Deployment MCP server AI personal assistant Python task automation OAuth authorization session management task tracking plugin marketplace

支持客户端

适用场景

Blend DeploymentMCP serverAI personal assistant

安装与配置

Streamable HTTP OAuth 授权
新一代远程传输,替代 SSE
https://mcp.pine.im/mcp

把它填进客户端的 MCP 配置即可,不需要在本地安装运行时。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Codex,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
pine-mcp-server当前 未标注 Streamable HTTP 远程部署 有 2026-09-21
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方19PINE-AI上游标注的维护方 19PINE-AI
分类浏览器工具本站按上游分类展示
连接方式Streamable HTTP新一代远程传输,替代 SSE
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-09-21上游最后核验时间

详细介绍

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

Pine Assistant MCP

Pine AI is a personal assistant for real-world tasks. This
repository provides the Pine Assistant plugin for MCP clients and the earlier local
Python stdio server.

Pine Assistant plugin

Pine Assistant (pine) connects a supported client to Pine through a remote MCP
server and opens browser-based OAuth authorization when the client connects.
Bring Pine AI into your agent to handle real-world tasks and follow up on
progress and results. The shared skill guides the agent through the available
tools and any details or account actions a task needs.

Install and authorize

Ask your agent to set up Pine:

> Read https://pine.im/features/mcp and help me install Pine.

Or follow the instructions for your client below.

Install Pine Assistant (pine) from the Pine AI (pine-ai) marketplace, then begin a new
conversation. Connect and complete the Pine browser authorization when your
client asks.

Codex```bash
codex plugin marketplace add https://github.com/19PINE-AI/pine-mcp-server.git --ref main
codex plugin add pine@pine-ai


To update it:```bash
codex plugin marketplace upgrade pine-ai
codex plugin add pine@pine-ai

Claude Code```bash
claude plugin marketplace add https://github.com/19PINE-AI/pine-mcp-server.git
claude plugin install pine@pine-ai


To update it:```bash
claude plugin marketplace update pine-ai
claude plugin update pine@pine-ai

Use Pine naturally after authorizing, for example:

> Use Pine to contact a nearby bike repair shop and ask about tune-up availability.

Pine keeps working after you leave. Ask your agent for progress or results when
you return. Complete payment, account connection, or phone verification in Pine
when the task directs you there.

In Codex, use $pine to load the shared guidance. In Claude Code, use
/pine:pine.

Connect from another MCP client

Add a Streamable HTTP MCP server with this configuration, then use the
client's Connect or Authorize control to complete OAuth in a browser:```json
{
"mcpServers": {
"pine": {
"type": "http",
"url": "https://mcp.pine.im/mcp"
}
}
}


### Cursor

Cursor supports the Pine Assistant plugin and a manual MCP connection.

For a local native plugin install, clone this repository, copy
`plugins/pine` to `~/.cursor/plugins/local/pine`, and reload Cursor:```bash
git clone https://github.com/19PINE-AI/pine-mcp-server.git
mkdir -p ~/.cursor/plugins/local
cp -R pine-mcp-server/plugins/pine ~/.cursor/plugins/local/pine

Use Developer: Reload Window, then enable Pine in Customize and complete
browser authorization. When updating, replace the existing local pine folder
instead of copying a second pine folder inside it. Team administrators can also
import this repository as a marketplace.

For a manual connection, add the Streamable HTTP configuration above in
Cursor's MCP settings, then use its authorization control.

Use Pine from your own agent with a Platform API key

A Pine Platform API partner can use the hosted Pine MCP server from its own
agent, on behalf of each of its end users. It authenticates with its secret key
and a Pine-Managed-User-Id header instead of browser OAuth, so it does not use
the plugin. See Use Pine MCP from your own agent.

Legacy local stdio server

The published pine-mcp-server Python package is separate from the plugin
distribution: pip and uvx do not install the
client plugin.
It runs a local stdio MCP server backed by the
pine-assistant SDK.

Install it with pip:```bash
pip install pine-mcp-server


Or run it without installing:```bash
uvx pine-mcp-server

Configure a stdio MCP client with the executable and Pine credentials. For
example:```json
{
"mcpServers": {
"pine-assistant": {
"command": "uvx",
"args": ["pine-mcp-server"],
"env": {
"PINE_ACCESS_TOKEN": "your-access-token",
"PINE_USER_ID": "your-user-id"
}
}
}
}


If installed with pip, use `pine-mcp-server` as `command` and omit `args`.
Alternatively, authenticate with the `pine_auth_request_code` and
`pine_auth_verify_code` tools. Do not put access tokens in plugin files.

### Environment

| Variable | Required | Description |
| --- | --- | --- |
| `PINE_ACCESS_TOKEN` | Yes* | Pine AI access token |
| `PINE_USER_ID` | Yes* | Pine AI user ID |
| `PINE_BASE_URL` | No | Pine AI backend URL (default: `https://www.19pine.ai`) |
| `PINE_DEVICE_ID` | No | Stable device identifier for subprocess clients; otherwise a new ID may be generated when `~/.pine/device_id` is unwritable. |

\* Not required when authenticating at runtime with the auth tools.

### Tools

| Area | Tools |
| --- | --- |
| Authentication | `pine_auth_request_code`, `pine_auth_verify_code` |
| Sessions | `pine_session_create`, `pine_session_list`, `pine_session_get`, `pine_session_delete`, `pine_session_url` |
| Conversation | `pine_get_history`, `pine_send_message`, `pine_send_form_response`, `pine_send_auth_confirmation`, `pine_send_location_response`, `pine_send_location_selection` |
| Tasks | `pine_task_start`, `pine_task_stop` |
| Attachments | `pine_upload_attachment`, `pine_delete_attachment` |
| Social and scheduling | `pine_social_share`, `pine_update_call_reminder` |

The local server follows a load-conversation model: create or select a
session, send a message, and read history for subsequent questions and
results. It does not stream real-time updates.

## Releases

Plugin releases use immutable `plugin-vX.Y.Z` tags. The Python package uses
`vX.Y.Z` tags and is published independently to PyPI. Keep all plugin manifest
versions synchronized before creating a plugin tag. Plugin tags run validation
without publishing to PyPI. Python tags must match the version in
`pyproject.toml` before publication.

The installation commands track `main`. Merge and validate a release before
tagging it, bump plugin versions when changing the package, and never move an
existing release tag. To pin a plugin release in Codex, add the repository with
`--ref plugin-vX.Y.Z` instead of `--ref main`. After updating a plugin, start a
new client conversation (or reload the client) to load its changes.

## Development

For plugin testing, clone this repository and edit `plugins/pine/.mcp.json` in
that working copy to point at the endpoint under test. Do not commit a local
endpoint or credentials. Use separate client configuration directories so the
local marketplace does not collide with your normal Pine installation.

From the repository root, test Codex:```bash
PINE_CODEX_TEST_CONFIG="$(mktemp -d)"
CODEX_HOME="$PINE_CODEX_TEST_CONFIG" codex plugin marketplace add .
CODEX_HOME="$PINE_CODEX_TEST_CONFIG" codex plugin add pine@pine-ai
CODEX_HOME="$PINE_CODEX_TEST_CONFIG" codex

Or Claude Code:```bash
PINE_CLAUDE_TEST_CONFIG="$(mktemp -d)"
CLAUDE_CONFIG_DIR="$PINE_CLAUDE_TEST_CONFIG" claude plugin marketplace add .
CLAUDE_CONFIG_DIR="$PINE_CLAUDE_TEST_CONFIG" claude plugin install pine@pine-ai
CLAUDE_CONFIG_DIR="$PINE_CLAUDE_TEST_CONFIG" claude


Keep the same temporary directory while testing. Each isolated client may
require its own client login and Pine authorization. Remove the temporary
configuration after testing; do not copy credentials into the repository.

Validate the Claude package and marketplace with:```bash
claude plugin validate plugins/pine --strict
claude plugin validate . --strict

CI also checks cross-client metadata and bundled paths. For the legacy Python
server's development dependencies:bash pip install -e ".[dev]"

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
pine-mcp-server 怎么安装?

在客户端按下面的安装命令接入:https://mcp.pine.im/mcp。装完在客户端配置里引用同一个包或端点。

pine-mcp-server 怎么在 Claude、Cursor、Codex 里配置?

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

pine-mcp-server 收费吗?

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

pine-mcp-server 需要 API Key 吗?

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

pine-mcp-server 支持哪些客户端?

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

pine-mcp-server 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、MCP server、AI personal assistant、Python、task automation、OAuth authorization。具体工具清单以官方文档为准。

pine-mcp-server 需要什么运行环境?

运行时为 python;属于远程端点,不需要在本地装运行时。

pine-mcp-server 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为Streamable HTTP。

热门专题

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

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