ファイルシステム
mcp-framework を使用して構築されたモデル コンテキスト プロトコル (MCP) サーバー。
クイックスタート
# Install dependencies
npm install
# Build the project
npm run build
Related MCP server: MCP Toolkit
プロジェクト構造
filesystem/
├── src/
│ ├── tools/ # MCP Tools
│ │ └── ExampleTool.ts
│ └── index.ts # Server entry point
├── package.json
└── tsconfig.jsonコンポーネントの追加
このプロジェクトにはsrc/tools/ExampleTool.tsにサンプルツールが付属しています。CLIを使用してツールを追加することもできます。
# Add a new tool
mcp add tool my-tool
# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handlerツール開発
ツール構造の例:
import { MCPTool } from "mcp-framework";
import { z } from "zod";
interface MyToolInput {
message: string;
}
class MyTool extends MCPTool<MyToolInput> {
name = "my_tool";
description = "Describes what your tool does";
schema = {
message: {
type: z.string(),
description: "Description of this input parameter",
},
};
async execute(input: MyToolInput) {
// Your tool logic here
return `Processed: ${input.message}`;
}
}
export default MyTool;npmへの公開
package.json を更新します。
nameが一意であり、npm の命名規則に従っていることを確認してください。適切な
versionを設定するdescription、author、licenseなどを追加します。binが正しいエントリファイルを指しているか確認する
ローカルでビルドしてテストします。
npm run build npm link filesystem # Test your CLI locallynpm にログインします (必要に応じてアカウントを作成します)。
npm loginパッケージを公開します:
npm publish
公開後、ユーザーはそれをクロードデスクトップクライアント（下記参照）に追加したり、npxで実行したりすることができます。
## Using with Claude Desktop
### Local Development
Add this configuration to your Claude Desktop config file:
**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"filesystem": {
"command": "node",
"args":["/absolute/path/to/filesystem/dist/index.js"]
}
}
}公開後
この構成を Claude Desktop 構成ファイルに追加します。
MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["filesystem"]
}
}
}構築とテスト
ツールに変更を加える
npm run buildを実行してコンパイルするサーバーは起動時にツールを自動的に読み込みます