运行TypeScript技能MCP服务器
一个MCP服务器，允许AI代理执行TypeScript代码，并访问 ~/.claude/skills.
这能带来什么
此MCP服务器提供了一个工具： run-skill-code。启用后，您的AI代理可以执行从中导入和调用函数的TypeScript代码 ~/.claude/skills.
为什么你可能想要这个
快速的程序化工作流程：它可以直接调用TypeScript函数并获取结构化数据，而不是您的代理重复调用命令行工具（缓慢的文本解析）。
更丰富的代理功能：如果你已经为任务管理、版本控制工作流、数据处理或其他工具构建了TypeScript API ~/.claude/skills，这允许代理以编程方式使用它们。
更好的性能：进程内执行比为每个操作生成进程快得多。
类型安全交互：您的代理将获得具有适当类型的结构化结果，而不是解析文本输出。
为什么你可能不想要这个
危险分子：代码在进程内执行，具有完全的文件系统访问权限，没有沙盒。如果您的代理编写恶意代码（或出错），它将在您的权限下运行。
有限用例：只有当你有（或计划构建）TypeScript API时才有用 ~/.claude/skills如果你不这样做，这个MCP就没有价值。
信任要求：您必须信任您的AI代理才能安全地编写和执行代码。没有安全网。
开发开销：你需要自己构建和维护TypeScript API。
何时使用此
适合:
- 你有TypeScript API
~/.claude/skills您希望代理商使用的 - 您信任您的AI代理能够安全地执行代码
- 您需要快速、程序化的工作流程
- 你对安全权衡很满意
不太合适:
- 您没有任何技能/API可供代理调用
- 你对进程内代码执行感到不舒服
- 您需要沙盒或安全隔离
- 您更喜欢命令行工具
安装
先决条件
- 包子 v1.0.0或更高版本
设置
git clone
cd run-typescript-skills-mcp
bun install
bun run build配置您的MCP客户端
VS Code (.vscode/settings.json):
{
"mcp": {
"servers": {
"run-typescript-skills": {
"command": "bun",
"args": ["/absolute/path/to/run-typescript-skills-mcp/src/mcp-bun.ts"]
}
}
}
}克劳德桌面版:
{
"mcpServers": {
"run-typescript-skills": {
"command": "bun",
"args": ["/absolute/path/to/run-typescript-skills-mcp/src/mcp-bun.ts"]
}
}
}你的代理人能做什么
启用后，您的代理可以执行TypeScript代码，如下所示：
import { createTask } from '~/.claude/skills/my-workflow/src/api.js';
const task = await createTask({
title: "Write documentation",
priority: 1
});
return task;代理返回结构化数据：
{
"returnValue": { "id": "task-123", "title": "Write documentation", "priority": 1 },
"stdout": "",
"stderr": ""
}安全模型
⚠️ 无沙盒：代码在进程内以完全系统访问权限运行。
⚠️ 与服务器具有相同的权限：如果MCP服务器可以访问文件，则执行的代码也可以。
⚠️ 基于信任：你相信你的AI代理会编写安全的代码。
这是为：受控环境，您信任您的代理，并希望快速、可编程地访问您自己的TypeScript API。
这不是为：执行不受信任的代码、多用户环境或需要隔离的情况。
发展
bun run build # Compile TypeScript
bun run dist # Build optimized bundle
bun test # Run tests
bun run dev # Development mode with MCP Inspector建筑
src/mcp-bun.ts-MCP服务器入口点src/tools/run-skill-code-mcp.ts-工具注册src/tools/run-skill-code.ts-公共APIsrc/tools/run-skill-code-impl.ts-实施
看 docs/adr/ 用于架构决策。
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。