Custom Domain MCP Server

🧠 财务健康和个性化MCP服务器

版本： 1.0.0

______________________________________________________________________

📘 概述

这 财务健康和个性化MCP服务器 是一个基于 模型上下文协议（MCP）. 它提供了一组智能工具，通过标准化的协议接口处理个人财务的各个方面，包括预算、债务管理、费用分类和净值计算。

该服务器使AI代理或客户端应用程序能够与财务数据模型交互，并生成个性化的见解、预测和合成（虚拟）财务档案，以进行测试或个性化。

______________________________________________________________________

⚙️ 核心功能

• 💰 预算编制工具 --生成并分析个人预算。
• 👤 财务概况工具 --创建和管理用户财务档案。
• 🎲 随机轮廓生成器 --生成真实的综合财务数据。
• 🧾 费用分类 --将交易分为直观的支出类别。
• 💳 债务偿还计划 --示范还款策略和时间表。
• 📊 净值计算器 --计算总财务状况（资产与负债）。
• 🔮 现金流预测 --预测未来的收入和支出。
• 🧠 MCP提示集成 --通过提示指令生成虚拟配置文件。
• ✅ 基于目标的建议 --建议实现目标的可行步骤。
• ✅ 合成轮廓生成 --生成真实的虚拟财务数据，用于测试或个性化。

______________________________________________________________________

🏗️ 项目结构

Server/
│
├── src/
│   ├── data/
│   │   └── financial.profiles.json
│   │
│   ├── lib/
│   │   ├── financial-profile-analyzer/
│   │   │   ├── calculate-risk-tolerance.ts
│   │   │   ├── created-at.ts
│   │   │   ├── finance-profiles.ts
│   │   │   ├── goal-based-recoms.ts
│   │   │   └── recommendations.ts
│   │   │
│   │   └── functions/
│   │       └── get-predict-dates.ts
│   │
│   ├── server.ts
│   │
│   └── tools/
│       ├── budgeting-tool.ts
│       ├── cash-flow-forecast.ts
│       ├── debt-repayments.ts
│       ├── expense-categorization.ts
│       ├── financial-profile-tool.ts
│       ├── net-worth.ts
│       └── random-financial-profile.ts
│
├── .gitignore
├── package.json
├── package-lock.json
├── tsconfig.json
└── README.md

______________________________________________________________________

每个工具模块向服务器注册一个符合MCP的工具，并公开与财务规划或分析相关的特定功能。

______________________________________________________________________

🧩 建筑

1. MCP服务器

该项目使用 @modelcontextprotocol/sdk 用于定义和管理MCP（模型上下文协议）服务器的包：

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

服务器定义：

• 工具 --用于财务任务的模块化功能。
• 提示词 --结构化的人工智能驱动指令。
• 资源 --潜在的共享数据或模型定义（目前未使用）。

______________________________________________________________________

2. 传输层

服务器通过以下方式进行通信 标准输入/输出（stdio）:

import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

这使其能够轻松地与CLI工具或MCP客户端集成。

______________________________________________________________________

3. 工具注册

每个财务模块都在MCP服务器上注册：

registerFinancialProfileTool(server);
registerBudgetingTool(server);
registerGenerateRandomFinancialProfileTool(server);
registerExpenseCategorizationTool(server);
registerDebtRepaymentTool(server);
registerNetWorthTool(server);
registerCashFlowTool(server);

每 registerXYZTool() 功能：

• 定义MCP工具模式。
• 提供输入验证（通过 zod).
• 公开一个执行工具逻辑的处理程序。

______________________________________________________________________

4. 提示词

内置提示 generate-dummy-financial-profile 使用以下字段创建逼真的合成配置文件：

{
  "name": "Jane Doe",
  "age": 32,
  "goals": [{"name": "Emergency Fund", "amount": 5000}],
  "income": {"salary": 75000, "freelance": 5000, "consulting": 0},
  "debts": [{"name": "Student Loan", "monthly_payment": 250, "interestRate": 15.5}],
  "transactionAggregates": [
    {"category": "Groceries", "totalAmount": 400, "month": "October"}
  ],
  "recurringMerchants": [
    {"name": "Netflix", "amount": 15, "frequency": "monthly"}
  ],
  "payDates": [{"date": "2025-11-01", "category": "Salary"}],
  "sessionContext": {}
}

______________________________________________________________________

🚀 安装

1.克隆存储库

git clone https://github.com/NuffSaid-Bore/Custom-Domain-MCP-Server.git
cd Custom-Domain-MCP-Server

2.安装依赖项

npm install

3.运行MCP服务器

nmp run server:inspect

4.运行构建手表

nmp run server:build:watch

服务器将启动并等待通过stdio进行通信。

______________________________________________________________________

🧠 用法

此MCP服务器旨在嵌入或连接到理解模型上下文协议的AI系统。

MCP客户端集成示例

如果使用MCP兼容客户端（如LangChain或LLM运行时）：

const { McpClient } = require("@modelcontextprotocol/sdk/client");
const client = new McpClient("stdio", { command: "node", args: ["index.js"] });

await client.connect();

const profile = await client.prompt("generate-dummy-financial-profile");
console.log(profile);

______________________________________________________________________

🧰 工具说明

______________________________________________________________________

🧾 示例：预算工具

模式和用法示例（简化）：

{
  "income": {"salary": 10000, "freelance": 500, "consulting": 500},
  "recurringMerchants": [
    {"category": "Rent", "amount": 1500, "month": "November" },
    {"category": "Utilities", "amount": 200, "month": "November"},
    {"category": "Groceries", "amount": 400, "month": "November"}
  ]
}

该工具可能会返回：

{
  "totalIncome": 11000,
  "totalExpenses": 2100,
  "savings": 2900,
  "savingsRate": 0.58
}

______________________________________________________________________

🧩 使用的技术

• Node.js（v18+）
• 模型上下文协议SDK
• 萨德 用于模式验证
• ES 模块 用于现代导入/导出语法

______________________________________________________________________

🛠️ 发展

要扩展此服务器，请执行以下操作：

1. 在中创建新工具 /tools/your-new-tool.js.

1. 使用定义输入/输出模式 zod.

1. 在中注册该工具 index.js:

   import { registerYourNewTool } from "./tools/your-new-tool";
   registerYourNewTool(server);

______________________________________________________________________

🤝 贡献

1. 分叉存储库。
2. 创建新的要素分支。
3. 提交你的更改。
4. 打开一个Pull Request，清楚地描述你的改进。

______________________________________________________________________

🧭 未来路线图

• 🔐 为多用户会话添加身份验证。
• 📈 整合外部财务API（Plaid、Yodlee等）。
• 💬 添加基于NLP的费用分类。
• 🧮 引入投资和退休规划模块。

______________________________________________________________________