Sharesight MCP服务器
一种模型上下文协议(MCP)服务器,为AI助手提供对 Sharesight 通过v3 API的投资组合跟踪平台。
快速开始
步骤1:获取OAuth凭据
你需要一个 客户端ID 和 客户端密钥 从Sharesight使用此服务器。
如何获取凭据:
- 联系Sharesight技术支持:support@sharesight.com请求API访问
- 访问 Sharesight API文档 更多信息
- API访问可能需要特定的Sharesight计划
步骤2:运行一次性身份验证
npx github:Haizzz/sharesight-mcp authCLI将:
- 提示输入您的客户端ID和客户端密码
- 显示要在浏览器中打开的URL
- 要求您登录Sharesight并授权该应用程序
- 提示您粘贴授权码
- 在本地保存令牌(它们会自动刷新)
步骤3:添加MCP服务器配置
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sharesight": {
"command": "npx",
"args": ["-y", "github:Haizzz/sharesight-mcp", "serve"],
"env": {
"SHARESIGHT_CLIENT_ID": "your_client_id",
"SHARESIGHT_CLIENT_SECRET": "your_client_secret"
}
}
}
}重新启动Claude Desktop,您就可以开始了!
概述
此MCP服务器使Claude和其他AI助手能够与Sharesight帐户进行交互,允许对投资组合、持股、自定义投资和绩效报告进行自然语言查询和操作。
什么是Sharesight?
Sharesight是一个投资组合跟踪平台,帮助投资者在多个市场跟踪他们的股票、ETF、共同基金和其他投资。它提供绩效报告、股息跟踪和税务报告功能。
什么是MCP?
这 模型上下文协议 是一个开放标准,使人工智能助手能够安全地连接到外部数据源和工具。
特性
此服务器公开 27工具 涵盖所有Sharesight v3 API端点:
投资组合管理
| 工具 | 说明 |
|---|---|
list_portfolios | 使用可选的合并视图列出所有用户投资组合 |
get_portfolio | 按ID获取详细的投资组合信息 |
list_portfolio_holdings | 列出特定投资组合中的所有持股 |
get_portfolio_user_setting | 获取投资组合的用户显示首选项 |
update_portfolio_user_setting | 更新图表类型、分组和其他显示设置 |
控股管理
| 工具 | 说明 |
|---|---|
list_holdings | 列出所有投资组合中的所有持股 |
get_holding | 通过可选的成本基础和历史值获取持有详情 |
update_holding | 更新保持设置(DRP配置) |
delete_holding | 从投资组合中删除持有 |
定制投资
| 工具 | 说明 |
|---|---|
list_custom_investments | 列出定制/未上市投资 |
get_custom_investment | 获取自定义投资详细信息 |
create_custom_investment | 创建新的自定义投资(房地产、债券等) |
update_custom_investment | 更新自定义投资属性 |
delete_custom_investment | 删除自定义投资 |
定制投资价格
| 工具 | 说明 |
|---|---|
list_custom_investment_prices | 获取自定义投资的价格历史记录 |
create_custom_investment_price | 添加新的价格条目 |
update_custom_investment_price | 修改现有价格条目 |
delete_custom_investment_price | 删除价格条目 |
息票利率(固定利率)
| 工具 | 说明 |
|---|---|
list_coupon_rates | 列出固定利率投资的利率 |
create_coupon_rate | 添加新的优惠券价格 |
update_coupon_rate | 修改优惠券价格 |
delete_coupon_rate | 删除优惠券利率 |
性能报告
| 工具 | 说明 |
|---|---|
get_performance_report | 详细的性能细分和收益分析 |
get_performance_index_chart | 用于可视化投资组合绩效的图表数据 |
其他
| 工具 | 说明 |
|---|---|
list_countries | 获取Sharesight支持的国家及其设置 |
show_coupon_code | 查看已申请的促销优惠券代码 |
apply_coupon_code | 应用促销优惠券代码 |
delete_coupon_code | 删除应用的优惠券代码 |
revoke_api_access | 断开API访问(使所有令牌无效) |
从源代码安装
git clone https://github.com/Haizzz/sharesight-mcp.git
cd sharesight-mcp
npm install
npm run build然后运行auth并配置:
node dist/index.js auth{
"mcpServers": {
"sharesight": {
"command": "node",
"args": ["/path/to/sharesight-mcp/dist/index.js", "serve"],
"env": {
"SHARESIGHT_CLIENT_ID": "your_client_id",
"SHARESIGHT_CLIENT_SECRET": "your_client_secret"
}
}
}
}令牌存储
OAuth令牌存储在:
- Linux/macOS:
~/.sharesight-mcp/tokens.json - 窗户:
%USERPROFILE%\.sharesight-mcp\tokens.json
令牌会自动刷新。要重新授权,请删除令牌文件并运行 sharesight-mcp auth 再一次。
错误处理
常见错误:
- 401 -访问令牌无效或过期
- 403 -令牌已撤销或权限不足
- 404 -未找到资源
- 422 -验证错误(检查字段值)
发展
npm run dev # Watch mode
npm run build # Build for production
npm start # Run the server许可证
麻省理工学院
支持
- Sharesight支持: support@sharesight.com
- API文档: https://api.sharesight.com/doc/api/v3
- MCP协议: https://modelcontextprotocol.io/
