AI导哈

AI工具连接服务

一个连接AI工具（Claude Desktop、Cursor、GitHub Copilot）到universal-portfolio实例的MCP服务器，提供读写portfolio内容的功能。

  • by muhammad-awais-web-dev
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 muhammad-awais-web-dev/portfolio-mcp-server

使用说明

组合mcp服务器

一 MCP（模型上下文协议） 将人工智能工具（Claude Desktop、Cursor、GitHub Copilot）直接连接到您的服务器 通用投资组合 例子

它做什么

通过stdio公开所有32个投资组合工具，因此任何兼容MCP的AI客户端都可以：

  • 阅读您的个人资料、项目、技能、证书、教育、经验和推荐信
  • 创建、更新和删除任何投资组合项（使用可写的API键）

相关

设置

1.安装依赖项

npm install

2.配置环境

cp .env.example .env

编辑 .env:

# URL of your running portfolio (local or deployed)
PORTFOLIO_URL=https://your-portfolio-domain.com

# API key from portfolio admin → Settings → API Keys
# Enable "can_write" on the key for write tool access
MCP_API_KEY=your_api_key_here

3.手动测试

npm start

对于自动重新加载的开发：

npm run dev

服务器通过以下方式进行通信 标准 --在MCP客户端连接之前，它不会打印任何内容。启动消息出现在stderr上。

连接到克劳德桌面

编辑 ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

重新启动克劳德桌面。你会看到 投资组合 列在MCP工具下。

连接到光标

编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

连接到VS代码

需要VS代码1.99+ GitHub Copilot 扩展。

创建或编辑 .vscode/mcp.json 在您的工作区中（或添加到您的用户 settings.json 在...之下 "mcp"):

{
  "servers": {
    "portfolio": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

打开 副驾驶聊天 面板，切换到 代理 模式，以及 portfolio 服务器将出现在可用工具下。

连接到GitHub Copilot CLI

编辑 ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "portfolio": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具（共32个）

读取工具-任何API密钥

工具 说明
get_profile 个人资料信息、个人简介、社交链接
list_projects 已发布项目（按类别/技能筛选，分页）
get_project 按ID或slug列出的单个项目
list_skills 所有技能（按类别筛选，分页）
get_skill 按ID或姓名列出的单一技能
list_certifications 所有认证
get_certification 通过ID进行单一认证
list_education 教育历程
get_education 按ID输入单一教育
list_experience 工作经验
get_experience 按ID输入单一体验
list_testimonials 推荐信（筛选功能）
get_testimonial 按ID提供的个人推荐

编写工具-API密钥 can_write = true

工具 说明
update_profile 更新姓名、个人简介、电子邮件、社交链接等。
create_project 创建新项目
update_project 按ID更新项目（包括 body_html)
delete_project 按ID删除项目
create_skill 创建新技能
update_skill 按ID更新技能
delete_skill 按ID删除技能
create_certification 创建新的证书
update_certification 按ID更新证书
delete_certification 按ID删除证书
create_education 创建教育条目
update_education 按ID更新教育
delete_education 按ID删除教育
create_experience 创建工作经验条目
update_experience 按ID更新体验
delete_experience 按ID删除体验
create_testimonial 创建推荐信
update_testimonial 按ID更新推荐信
delete_testimonial 按ID删除推荐

示例提示（一旦连接到Claude/Cursor/Copilot）

  • “列出我的所有项目”
  • “我在后端类别中有哪些技能？”
  • “将我的个人资料更新为：我是一名全栈开发人员…”
  • “在DevOps类别中创建一种名为Docker的新技能”
  • “更新项目5——将body_html设置为： <p>New description</p>"
  • “使用slug‘my app’发布项目”

需求

  • Node.js 18+
  • 跑步 通用投资组合 例子
  • MCP API密钥（在投资组合管理面板中生成）

相关 MCP