Token导航 LogoToken导航TokenDH.com
SourceSync.AI MCP Server logo
文档知识stdio官方级别未说明来源级核验

SourceSync.AI MCP Server

MCP Server

@smithery/cli

SourceSync.ai MCP Server 是一个用于知识管理的标准化接口服务器,允许AI模型通过协议与知识管理平台交互,支持内容摄取、文档管理和语义搜索等功能。

工具数

28

提示词数

0

GitHub Stars

1

资源数

0
知识管理搜索JavaScriptClaudeClaude DesktopClaudeCursorWindsurf

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

scmdr

提供方

scmdr

最后核验

2026/5/17 20:21

运行时

Node.js

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

npx -y @smithery/cli install @pbteja1998/sourcesyncai-mcp --client claude

详细介绍

SourceSync.ai MCP服务器

](https://smithery.ai/server/@pbteja1998/sourcesyncai-mcp)

模型上下文协议(MCP)服务器实现 SourceSync.ai API该服务器允许AI模型通过标准化的接口与SourceSync.AI的知识管理平台进行交互。

特性

  • 管理命名空间以组织知识
  • 从各种来源(文本、网址、网站、外部服务)获取内容
  • 检索、更新和管理存储在知识库中的文档
  • 对知识库执行语义搜索和混合搜索
  • 直接从解析的文本URL访问文档内容
  • 管理与外部服务的连接
  • 默认配置支持无缝AI集成

安装

使用npx运行

# Install and run with your API key and tenant ID
env SOURCESYNC_API_KEY=your_api_key npx -y sourcesyncai-mcp

通过Smithery安装

通过以下方式自动安装克劳德桌面的sourcesyncai mcp 史密瑟里:

npx -y @smithery/cli install @pbteja1998/sourcesyncai-mcp --client claude

手动安装

# Clone the repository
git clone https://github.com/yourusername/sourcesyncai-mcp.git
cd sourcesyncai-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
node dist/index.js

在游标上运行

要在游标中配置SourceSync.ai MCP,请执行以下操作:

  1. 打开光标设置
  2. 首选 Features > MCP Servers
  3. 点击 + Add New MCP Server
  4. 输入以下内容:

- 姓名: sourcesyncai-mcp (或您喜欢的名字) - 类型: command - 命令: env SOURCESYNCAI_API_KEY=your-api-key npx -y sourcesyncai-mcp

添加后,您可以通过描述您的知识管理需求,使用具有Cursor ai功能的SourceSync.ai工具。

在风帆上跑步

将此添加到您的 ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "sourcesyncai-mcp": {
      "command": "npx",
      "args": ["-y", "soucesyncai-mcp"],
      "env": {
        "SOURCESYNC_API_KEY": "your_api_key",
        "SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
        "SOURCESYNC_TENANT_ID": "your_tenant_id"
      }
    }
  }
}

在Claude桌面上运行

要将此MCP服务器与Claude Desktop一起使用:

  1. 找到Claude Desktop配置文件:

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

  1. 编辑配置文件以添加SourceSync.ai MCP服务器:
{
  "mcpServers": {
    "sourcesyncai-mcp": {
      "command": "npx",
      "args": ["-y", "sourcesyncai-mcp"],
      "env": {
        "SOURCESYNC_API_KEY": "your_api_key",
        "SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
        "SOURCESYNC_TENANT_ID": "your_tenant_id"
      }
    }
  }
}
  1. 保存配置文件并重新启动Claude Desktop

配置

环境变量

必需

  • SOURCESYNC_API_KEY:您的SourceSync.ai API密钥(必需)

可选的

  • SOURCESYNC_NAMESPACE_ID:用于操作的默认命名空间ID
  • SOURCESYNC_TENANT_ID:您的租户ID(可选)

配置示例

具有默认值的基本配置:

export SOURCESYNC_API_KEY=your_api_key
export SOURCESYNC_TENANT_ID=your_tenant_id
export SOURCESYNC_NAMESPACE_ID=your_namespace_id

可用工具

认证

  • validate_api_key:验证SourceSync.ai API密钥
{
  "name": "validate_api_key",
  "arguments": {}
}

命名空间

  • create_namespace:创建新命名空间
  • list_namespaces:列出所有命名空间
  • get_namespace:获取特定命名空间的详细信息
  • update_namespace:更新命名空间
  • delete_namespace:删除命名空间
{
  "name": "create_namespace",
  "arguments": {
    "name": "my-namespace",
    "fileStorageConfig": {
      "provider": "S3_COMPATIBLE",
      "config": {
        "endpoint": "s3.amazonaws.com",
        "accessKey": "your_access_key",
        "secretKey": "your_secret_key",
        "bucket": "your_bucket",
        "region": "us-east-1"
      }
    },
    "vectorStorageConfig": {
      "provider": "PINECONE",
      "config": {
        "apiKey": "your_pinecone_api_key",
        "environment": "your_environment",
        "index": "your_index"
      }
    },
    "embeddingModelConfig": {
      "provider": "OPENAI",
      "config": {
        "apiKey": "your_openai_api_key",
        "model": "text-embedding-3-small"
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "list_namespaces",
  "arguments": {
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "get_namespace",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "update_namespace",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "name": "updated-namespace-name"
  }
}
{
  "name": "delete_namespace",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX"
  }
}

数据摄入

  • ingest_text:摄入文本内容
  • ingest_urls:从URL中获取内容
  • ingest_sitemap:从站点地图中获取内容
  • ingest_website:从网站摄取内容
  • ingest_notion:从Notion摄取内容
  • ingest_google_drive:从Google云端硬盘获取内容
  • ingest_dropbox:从Dropbox获取内容
  • ingest_onedrive:从OneDrive摄取内容
  • ingest_box:从Box中摄取内容
  • get_ingest_job_run_status:获取摄取作业运行的状态
{
  "name": "ingest_text",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "TEXT",
      "config": {
        "name": "example-document",
        "text": "This is an example document for ingestion.",
        "metadata": {
          "category": "example",
          "author": "AI Assistant"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_urls",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "URLS",
      "config": {
        "urls": ["https://example.com/page1", "https://example.com/page2"],
        "metadata": {
          "source": "web",
          "category": "documentation"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_sitemap",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "SITEMAP",
      "config": {
        "url": "https://example.com/sitemap.xml",
        "metadata": {
          "source": "sitemap",
          "website": "example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_website",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "WEBSITE",
      "config": {
        "url": "https://example.com",
        "maxDepth": 3,
        "maxPages": 100,
        "metadata": {
          "source": "website",
          "domain": "example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_notion",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "NOTION",
      "config": {
        "connectionId": "your_notion_connection_id",
        "metadata": {
          "source": "notion",
          "workspace": "My Workspace"
        }
      }
    },
    "tenantId": "your_tenant_id"
  }
}
{
  "name": "ingest_google_drive",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "GOOGLE_DRIVE",
      "config": {
        "connectionId": "connection_XXX",
        "metadata": {
          "source": "google_drive",
          "owner": "user@example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_dropbox",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "DROPBOX",
      "config": {
        "connectionId": "connection_XXX",
        "metadata": {
          "source": "dropbox",
          "account": "user@example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_onedrive",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "ONEDRIVE",
      "config": {
        "connectionId": "connection_XXX",
        "metadata": {
          "source": "onedrive",
          "account": "user@example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "ingest_box",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestConfig": {
      "source": "BOX",
      "config": {
        "connectionId": "connection_XXX",
        "metadata": {
          "source": "box",
          "owner": "user@example.com"
        }
      }
    },
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "get_ingest_job_run_status",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "ingestJobRunId": "ingest_job_run_XXX",
    "tenantId": "tenant_XXX"
  }
}

文件

  • getDocuments:使用可选筛选器检索文档
  • updateDocuments:更新文档元数据
  • deleteDocuments:删除文档
  • resyncDocuments:重新同步文档
  • fetchUrlContent:从文档URL获取文本内容
{
  "name": "getDocuments",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "filterConfig": {
      "documentTypes": ["PDF"]
    },
    "includeConfig": {
      "parsedTextFileUrl": true
    }
  }
}
{
  "name": "updateDocuments",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "documentIds": ["doc_XXX", "doc_YYY"],
    "filterConfig": {
      "documentIds": ["doc_XXX", "doc_YYY"]
    },
    "data": {
      "metadata": {
        "status": "reviewed",
        "category": "technical"
      }
    }
  }
}
{
  "name": "deleteDocuments",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "documentIds": ["doc_XXX", "doc_YYY"],
    "filterConfig": {
      "documentIds": ["doc_XXX", "doc_YYY"]
    }
  }
}
{
  "name": "resyncDocuments",
  "arguments": {
    "namespaceId": "namespace_XXX",
    "tenantId": "tenant_XXX",
    "documentIds": ["doc_XXX", "doc_YYY"],
    "filterConfig": {
      "documentIds": ["doc_XXX", "doc_YYY"]
    }
  }
}
{
  "name": "fetchUrlContent",
  "arguments": {
    "url": "https://api.sourcesync.ai/v1/documents/doc_XXX/content?format=text",
    "apiKey": "your_api_key",
    "tenantId": "tenant_XXX"
  }
}

搜索

  • semantic_search:执行语义搜索
  • hybrid_search:执行混合搜索(语义+关键字)
{
  "name": "semantic_search",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "query": "example document",
    "topK": 5,
    "tenantId": "tenant_XXX"
  }
}
{
  "name": "hybrid_search",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "query": "example document",
    "topK": 5,
    "tenantId": "tenant_XXX",
    "hybridConfig": {
      "semanticWeight": 0.7,
      "keywordWeight": 0.3
    }
  }
}

连接

  • create_connection:创建与外部服务的新连接
  • list_connections:列出所有连接
  • get_connection:获取特定连接的详细信息
  • update_connection:更新连接
  • revoke_connection:撤消连接
{
  "name": "create_connection",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "name": "My Connection",
    "connector": "GOOGLE_DRIVE",
    "clientRedirectUrl": "https://your-app.com/callback"
  }
}
{
  "name": "list_connections",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX"
  }
}
{
  "name": "get_connection",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "connectionId": "connection_XXX"
  }
}
{
  "name": "update_connection",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "connectionId": "connection_XXX",
    "name": "Updated Connection Name",
    "clientRedirectUrl": "https://your-app.com/updated-callback"
  }
}
{
  "name": "revoke_connection",
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "connectionId": "connection_XXX"
  }
}

示例提示

以下是配置MCP服务器后可以与Claude或Cursor一起使用的一些示例提示:

  • “在我的SourceSync知识库中搜索有关机器学习的信息。”
  • “将此文章纳入我的SourceSync知识库:\[URL\]”
  • “在SourceSync中为我的项目文档创建一个新的命名空间。”
  • “列出我的SourceSync命名空间中的所有文档。”
  • “从我的SourceSync命名空间获取文档\[document_id\]的文本内容。”

故障排除

连接问题

如果在连接SourceSync.ai MCP服务器时遇到问题:

  1. 验证路径:确保配置中的所有路径都是绝对路径,而不是相对路径。
  1. 检查权限:确保服务器文件具有执行权限(chmod +x dist/index.js).
  1. 启用开发人员模式:在Claude Desktop中,启用开发人员模式并检查MCP日志文件。
  1. 测试服务器:直接从命令行运行服务器:
   node /path/to/sourcesyncai-mcp/dist/index.js
  1. 重新启动AI客户端:更改后,完全重新启动Claude Desktop或Cursor。
  1. 检查环境变量:确保所有必需的环境变量都已正确设置。

调试日志记录

有关详细的日志记录,请添加DEBUG环境变量:

发展

项目结构

  • src/index.ts:主要入口点和服务器设置
  • src/schemas.ts:所有工具的模式定义
  • src/sourcesync.ts:用于与SourceSync.ai API交互的客户端
  • src/sourcesync.types.ts:TypeScript类型定义

建造和测试

# Build the project
npm run build

# Run tests
npm test

许可证

麻省理工学院

链接

文档内容检索工作流程:

  1. 首先,使用 getDocuments 随着 includeConfig.parsedTextFileUrl: true 获取包含其内容URL的文档
  2. 从文档响应中提取URL
  3. 使用 fetchUrlContent 以检索实际内容:
{
  "name": "fetchUrlContent",
  "arguments": {
    "url": "https://example.com"
  }
}

目录标签

目录标签

知识管理搜索JavaScriptClaude本地部署AI集成语义搜索文档处理外部服务连接

支持客户端

Claude DesktopClaudeCursorWindsurf

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

api-key

运行时(runtime,运行环境)

Node.js

部署方式(deploymentType,部署类型)

remote-capable

来源包(packageName,安装包名)

@smithery/cli

工具数量(toolCount,工具数)

28

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdioapi-keyremote-capable

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP