Linq

io.github.linq-team由 GitHub 账号 linq-team 发布v0.79.0更新于 Nov 6, 2026

Send and manage iMessage, RCS, and SMS conversations through the Linq API.

已验证STDIO仅桌面开发者工具沟通与协作

概览

AI 生成的概览

让助手在沙箱中编写 TypeScript 调用 Linq API,从而发送和管理 iMessage、RCS 与 SMS 会话。

可以做什么
  • 检索 Linq SDK 文档,查找方法、参数与用法示例
  • 在隔离沙箱中针对已预认证的 Linq API 客户端运行 TypeScript 代码
  • 通过代码发送和管理 iMessage、RCS 与 SMS 会话
  • 返回或打印每次运行的结果,因为变量不会在多次调用之间保留
适用场景
当你希望助手处理 Linq 消息业务(发送或管理 iMessage、RCS 与 SMS 会话),并且接受由它编写并运行 SDK 代码而不是调用固定工具时适用。
运行要求
以 npm 包形式通过 npx 在本地运行,需要 Node.js。需要 Linq API 密钥,放在 LINQ_API_V3_API_KEY 中;README 还提到 LINQ_WEBHOOK_SECRET。需要访问 Linq API 的网络。也可选以远程 HTTP 服务器方式启动,使用 Authorization Bearer 头或 x-linq-api-v3-api-key 头。
安装前请注意
服务器持有 Linq API 密钥(LINQ_API_V3_API_KEY),README 还涉及 LINQ_WEBHOOK_SECRET,请勿放入共享配置。生成的代码可在你的 Linq 账户上发送消息并改变会话状态,应审阅助手实际执行的内容。代码在无网络和文件系统访问的沙箱中运行,单次请求 30 秒超时,每次执行约 5 分钟上限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Linq,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Linq API V3 TypeScript MCP Server

It is generated with Stainless.

Installation

Direct invocation

You can run the MCP Server directly via npx:

sh
export LINQ_API_V3_API_KEY="My API Key"export LINQ_WEBHOOK_SECRET="My Webhook Secret"npx -y @linqapp/sdk-mcp@latest

Via MCP Client

There is a partial list of existing clients at modelcontextprotocol.io. If you already have a client, consult their documentation to install the MCP server.

For clients with a configuration JSON, it might look something like this:

json
{  "mcpServers": {    "linqapp_sdk_api": {      "command": "npx",      "args": ["-y", "@linqapp/sdk-mcp"],      "env": {        "LINQ_API_V3_API_KEY": "My API Key",        "LINQ_WEBHOOK_SECRET": "My Webhook Secret"      }    }  }}

Cursor

If you use Cursor, you can install the MCP server by using the button below. You will need to set your environment variables in Cursor's mcp.json, which can be found in Cursor Settings > Tools & MCP > New MCP Server.

[Add to Cursor]

VS Code

If you use MCP, you can install the MCP server by clicking the link below. You will need to set your environment variables in VS Code's mcp.json, which can be found via Command Palette > MCP: Open User Configuration.

Open VS Code

Claude Code

If you use Claude Code, you can install the MCP server by running the command below in your terminal. You will need to set your environment variables in Claude Code's .claude.json, which can be found in your home directory.

claude mcp add linqapp_sdk_mcp_api --env LINQ_API_V3_API_KEY="My API Key" LINQ_WEBHOOK_SECRET="My Webhook Secret" -- npx -y @linqapp/sdk-mcp

Code Mode

This MCP server is built on the "Code Mode" tool scheme. In this MCP Server, your agent will write code against the TypeScript SDK, which will then be executed in an isolated sandbox. To accomplish this, the server will expose two tools to your agent:

  • The first tool is a docs search tool, which can be used to generically query for documentation about your API/SDK.

  • The second tool is a code tool, where the agent can write code against the TypeScript SDK. The code will be executed in a sandbox environment without web or filesystem access. Then, anything the code returns or prints will be returned to the agent as the result of the tool call.

Using this scheme, agents are capable of performing very complex tasks deterministically and repeatably.

Running remotely

Launching the client with --transport=http launches the server as a remote server using Streamable HTTP transport. The --port setting can choose the port it will run on, and the --socket setting allows it to run on a Unix socket.

Authorization can be provided via the Authorization header using the Bearer scheme.

Additionally, authorization can be provided via the following headers:

HeaderEquivalent client optionSecurity scheme
x-linq-api-v3-api-keyapiKeyBearerAuth

A configuration JSON for this server might look like this, assuming the server is hosted at http://localhost:3000:

json
{  "mcpServers": {    "linqapp_sdk_api": {      "url": "http://localhost:3000",      "headers": {        "Authorization": "Bearer <auth value>"      }    }  }}

来源:packages/mcp-server/README.md,提交 8a85ce3

工具

2

execute

Runs JavaScript code to interact with the Linq API V3 API. You are a skilled TypeScript programmer writing code to interface with the service. Define an async function named "run" that takes a single parameter of an initialized SDK client and it will be run. For example: ``` async function run(client) { const chat = await client.chats.create({ from: '+12052535597', message: {}, to: ['+12052532136'], }); console.log(chat.chat); } ``` You will be returned anything that your function returns, plus the results of any console.log statements. Do not add try-catch blocks for single API calls. The tool will handle errors for you. Do not add comments unless necessary for generating better code. Code will run in a container, and cannot interact with the network outside of the given SDK client. Variables will not persist between calls, so make sure to return or log any data you might need later. Remember that you are writing TypeScript code, so you need to be careful with your types. Always type dynamic key-value stores explicitly as Record<string, YourValueType> instead of {}.

输入参数code必填intent

search_docs

Search SDK documentation to find methods, parameters, and usage examples for interacting with the API. Use this before writing code when you need to discover the right approach.

输入参数query必填detaillanguage必填

版本历史

1
  1. v0.79.0最新Nov 6, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分