towerim 1.0.15 → 1.0.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +93 -0
- package/package.json +1 -18
- package/tower.cjs +25 -0
- package/bin/tower +0 -0
package/README.md
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# Tower MCP(AgentsTower)
|
|
2
|
+
|
|
3
|
+
把 Tower.im 接入 AI 客户端(Claude Code、Codex、Cursor 等)的命令行与服务工具。编译后会得到一个独立的 `tower` 程序,同时支持两种使用方式:
|
|
4
|
+
|
|
5
|
+
1. **个人本地使用(stdio MCP)**:在自己电脑上运行 `tower login` 登录 Tower 账号,然后把 `tower mcp` 配进 AI 客户端,直接读写团队、项目、任务、知识库和工时。
|
|
6
|
+
2. **团队自托管(HTTP MCP + 网页控制台)**:在服务器上运行 `tower serve`,团队成员在网页上绑定自己的 Tower 账号并获取 `at_sk-...` 密钥,就能通过 HTTP 地址接入 MCP;同时自带网页版 REST API / MCP 调试台和成员管理后台。
|
|
7
|
+
|
|
8
|
+
两种模式共用同一套 MCP 工具和 SQLite 存储逻辑。
|
|
9
|
+
|
|
10
|
+
## npm 安装
|
|
11
|
+
|
|
12
|
+
Windows、macOS 和 Linux 均支持 x64 与 arm64。运行 `npm install -g towerim` 后即可使用 `tower login`。MCP 客户端也可以通过 `npx --yes towerim@latest mcp` 启动。npm 会按当前 Node.js 的系统和架构安装对应的二进制包,请保留可选依赖。
|
|
13
|
+
|
|
14
|
+
## 编译构建
|
|
15
|
+
|
|
16
|
+
在仓库根目录执行(需要 Go 1.26、Node.js 和 pnpm):
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
make install
|
|
20
|
+
make build
|
|
21
|
+
./server/bin/tower --version
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
编译产物为 `server/bin/tower`,前端网页控制台已内嵌在二进制中。
|
|
25
|
+
|
|
26
|
+
## 常用命令
|
|
27
|
+
|
|
28
|
+
| 命令 | 说明 |
|
|
29
|
+
| --- | --- |
|
|
30
|
+
| `tower login [--reconfigure]` | 在终端登录 Tower 账号并保存本地凭据(加 `--reconfigure` 可重填 OAuth 应用配置) |
|
|
31
|
+
| `tower status` | 查看本地配置目录、当前绑定的 Tower 账号、Token 与网页会话状态 |
|
|
32
|
+
| `tower logout [--all]` | 退出本地绑定的 Tower 账号(加 `--all` 同时清除 OAuth 应用配置) |
|
|
33
|
+
| `tower mcp`(或直接运行 `tower`) | 启动本地 stdio MCP 服务(供 AI 客户端调用) |
|
|
34
|
+
| `tower serve` | 启动网页控制台和 Streamable HTTP MCP 服务 |
|
|
35
|
+
| `tower user list` | 列出数据库中的所有用户 |
|
|
36
|
+
| `tower user reset-password <用户名> <新密码>` | 重置指定用户密码 |
|
|
37
|
+
| `tower admin grant <用户名>` | 授予管理员权限 |
|
|
38
|
+
| `tower admin revoke <用户名>` | 取消管理员权限 |
|
|
39
|
+
| `tower --version` | 查看当前版本号 |
|
|
40
|
+
|
|
41
|
+
## 方式一:个人本地使用(stdio MCP)
|
|
42
|
+
|
|
43
|
+
1. 在终端运行:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
./server/bin/tower login
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
如果当前环境尚未配置 Tower OAuth 应用信息,程序会提示输入 `Client ID`、`Client Secret` 和回调地址;之后选择邮箱密码或微信扫码登录,程序会自动完成授权并保存凭据。
|
|
50
|
+
|
|
51
|
+
2. 在 AI 客户端配置 MCP,命令填 `tower` 的绝对路径,参数填 `mcp`(以 Codex 为例):
|
|
52
|
+
|
|
53
|
+
```toml
|
|
54
|
+
[mcp_servers.tower]
|
|
55
|
+
command = "/绝对路径/server/bin/tower"
|
|
56
|
+
args = ["mcp"]
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
3. 将 [本地 Skill](standalone/SKILL.md) 安装到你的 Agent Skill 目录,帮助 Agent 正确使用各项工具。
|
|
60
|
+
|
|
61
|
+
**本地数据说明**:
|
|
62
|
+
- 默认数据库路径为 `~/.config/tower/tower.db`;若设置了 `XDG_CONFIG_HOME`,则存放在 `$XDG_CONFIG_HOME/tower/tower.db`;也可以用 `TOWER_CONFIG_DIR` 直接指定存放目录。
|
|
63
|
+
- 多个 Agent 共用同一配置目录时,会共享本地账号和默认绑定的 Tower 账号。
|
|
64
|
+
- 历史版本的 `credentials.json` 会在启动时自动导入到 SQLite 数据库。
|
|
65
|
+
|
|
66
|
+
## 方式二:团队自托管(HTTP 服务)
|
|
67
|
+
|
|
68
|
+
1. 复制并编辑环境变量配置:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
cp server/.env.example server/.env
|
|
72
|
+
# 填写 TOWER_CLIENT_ID、TOWER_CLIENT_SECRET 等配置
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
2. 启动服务:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
make run
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
`make run` 会在 `server/` 目录下执行 `go run . serve`。如果直接运行编译好的二进制,可在 `server/` 目录下执行 `./bin/tower serve`(同样会读取 `server/.env`)。
|
|
82
|
+
|
|
83
|
+
服务默认监听 `[::]:8888`,数据库默认使用 `server/data/data.db`,MCP 接口路径为 `/mcp`。完整的环境变量、命令行管理和接入示例见 [HTTP 服务说明](server/README.md)。
|
|
84
|
+
|
|
85
|
+
> **提示**:如果想用网页控制台来管理本地模式的 `tower.db`,只需启动 `tower serve` 时将 `DB_PATH` 指向该 `tower.db`(并配置好相同的 Tower OAuth 应用信息)。本地模式自动创建的默认用户名为 `standalone`,初始密码也是 `standalone`;如果要对外开放端口,请先修改该密码。
|
|
86
|
+
|
|
87
|
+
## 开发、测试与更多文档
|
|
88
|
+
|
|
89
|
+
- `make dev`:同时启动 Go 后端热重载(Air)与前端 Vite 开发服务。
|
|
90
|
+
- `make test`:构建前端并运行全部 Go 测试和 `go vet`。
|
|
91
|
+
- `make test-standalone`:只运行本地模式相关的测试。
|
|
92
|
+
- `make docker-build`:构建默认运行 `tower serve` 的 Docker 镜像;生产发布与回滚见 [单机蓝绿部署](deploy/README.md)。
|
|
93
|
+
- 目录说明:`standalone/` 存放本地 Skill,`server/` 为 Go 服务端与前端控制台源码,`docs/` 为 [Tower API 参考文档](docs/README.md)。
|
package/package.json
CHANGED
|
@@ -1,18 +1 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "towerim",
|
|
3
|
-
"version": "1.0.15",
|
|
4
|
-
"description": "Tower MCP server and CLI",
|
|
5
|
-
"bin": {
|
|
6
|
-
"tower": "bin/tower"
|
|
7
|
-
},
|
|
8
|
-
"os": [
|
|
9
|
-
"linux"
|
|
10
|
-
],
|
|
11
|
-
"cpu": [
|
|
12
|
-
"x64"
|
|
13
|
-
],
|
|
14
|
-
"files": [
|
|
15
|
-
"bin/tower",
|
|
16
|
-
"SKILL.md"
|
|
17
|
-
]
|
|
18
|
-
}
|
|
1
|
+
{"version": "1.0.16", "name": "towerim", "description": "Tower MCP server and CLI", "bin": {"tower": "tower.cjs"}, "optionalDependencies": {"@xxn6141/towerim-linux-x64": "1.0.16", "@xxn6141/towerim-linux-arm64": "1.0.16", "@xxn6141/towerim-darwin-x64": "1.0.16", "@xxn6141/towerim-darwin-arm64": "1.0.16", "@xxn6141/towerim-win32-x64": "1.0.16", "@xxn6141/towerim-win32-arm64": "1.0.16"}}
|
package/tower.cjs
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
const { spawn } = require('node:child_process');
|
|
3
|
+
const name = `@xxn6141/towerim-${process.platform}-${process.arch}`;
|
|
4
|
+
const binary = process.platform === 'win32' ? 'tower.exe' : 'tower';
|
|
5
|
+
let executable;
|
|
6
|
+
try {
|
|
7
|
+
executable = require.resolve(`${name}/bin/${binary}`);
|
|
8
|
+
} catch {
|
|
9
|
+
const supported = Object.hasOwn(require('./package.json').optionalDependencies, name);
|
|
10
|
+
console.error(supported
|
|
11
|
+
? `Missing ${name}. Reinstall towerim with npm --include=optional.`
|
|
12
|
+
: `Unsupported platform: ${process.platform} ${process.arch}`);
|
|
13
|
+
process.exit(1);
|
|
14
|
+
}
|
|
15
|
+
const child = spawn(executable, process.argv.slice(2), { stdio: 'inherit' });
|
|
16
|
+
for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
|
|
17
|
+
process.on(signal, () => child.kill(signal));
|
|
18
|
+
}
|
|
19
|
+
child.on('error', error => {
|
|
20
|
+
console.error(error.message);
|
|
21
|
+
process.exitCode = 1;
|
|
22
|
+
});
|
|
23
|
+
child.on('exit', (code, signal) => {
|
|
24
|
+
process.exitCode = code ?? (128 + require('node:os').constants.signals[signal]);
|
|
25
|
+
});
|
package/bin/tower
DELETED
|
Binary file
|